Upgrading Your Tiki

If you already have a Tiki site, upgrading to the current release is easy. Be sure to read the release notes for complete information about the new release, including any specific migration issues.

Update the Tiki Files

1. Backup your database.
2. Backup any Tiki files that you customized. This includes any theme or style customizations.
   

    Tip

   If you customize any Tiki templates (TPL files) or styles (CSS files) you should do so in your own theme — not by changing existing theme files. This will make the upgrade process much easier.
3. Download the latest Tiki archive (or patch set, if available). See Downloading Tiki for details.
4. Copy the Tiki files to your web host. See Copying the Files to your Host for details.
5. Reapply any Tiki customizations (from the files you backed-up in step 2). For themes and styles, simply copy the files to the appropriate Tiki directory.
   • Place your custom theme files in: ../themes/YOURSTYLE.CSS/..
     • css
     • fonts
     • icons
     • images
     • less
     • options
     • templates

Update your Database

Now that the new Tiki files are on your web host, you can use the Tiki installer to upgrade your database.

1. Open your web browser to: http://www.yourdomain.com/tiki-install.php.
   

    Note

   If you copied the Tiki files to a subdirectory, include it, too. For example: http://www.yourdomain.com/subdirectory/tiki-install.php.
   
   

    Tip

   Tiki has been translated to more than 40 different languages. To access the installer in your language, use http://www.yourdomain.com/tiki-install.php?lang=XX, where XX is the two-letter ISO code for the language.
   
   If the message Installer disabled. Remove 'db/lock' to enable the installer. appears instead of the Tiki installer screen, that means you locked the installer. See this troubleshooting page for information on re-enabling the installer.
   
   For your protection, you must unlock the installer first.
2. On the Tiki installer Security Precaution screen, enter your Database administrator password and click Validate and Continue.
   
   

    Note

   This is the database username and password that you used when you configured the database connection.
   If you have forgotten this information, it is located in your ../db/local.php file.
3. On the Tiki installer page, go directly to Step 5: Install & Upgrade.
   
4. On the Tiki installer screen, in the Upgrade area, click Upgrade to upgrade your database to the current Tiki version.
   
   File not found.
   
   

    Note

   To completely reinstall the database (that is, remove your existing database and start with a brand new install), click Reinstall The Database in the Installation area.
   
   This should take only a few moments, as Tiki busily upgrades your database tables. Upon completion, the final installer screen appears.
   
   File not found.
   
   

    Note

   Review any warnings or notices that Tiki displays. Especially important is the PHP Memory notice. Tiki requires at least 32MB of PHP memory. Review the Tiki Installation Requirements document for details.

You should be greeted by your Tiki's home page. Be sure to review the release notes for the new version (available on the Tiki Community Portal) for details on the new features available in this release.