Upgrading to the Current Release

New Tiki releases are announced on http://tikiwiki.org. To keep your Tiki safe, always upgrade to the current, stable release.

Warning: Always back up your Tiki files and database before upgrading.

Using a Patchset

For incremental releases (such as from 5.3 to 5.4), you can download a patchset that contains only the files and database definitions that have been changed.



To install the patchset:

Warning: Be sure to back up your customizations 'before'' running the Tiki Installer.

1. Download the patchset from SourceForge.net.
2. Unpack the archive into your Tiki directory. The new files will automatically overwrite the existing files.
3. Locate the version-specific .sql file in the ../db/ folder and execute it against your database.
   

   Note: Not all patchsets will contain database updates.

4. Use the Tiki Installer and select the Upgrade option, as shown here.

Installing full Version

You can also upgrade your Tiki by installing the latest, full version.

Warning: Be sure to back up your customizations before running the Tiki Installer.

1. Download the Tiki release from http://tikiwiki.org and expand the archive on your host.
2. Run the Tiki installer by opening your browser to http://YOUR_DOMAIN/tiki-install.php.
   

   Tip: Refer to the Installation Instructions in Tiki for Dummies Smarties for complete details, including how to "unlock" your site and how to complete the Security Precaution page.

3. Tiki should automatically detect that you are upgrading an existing site. Click the link to go directly to the Install/Upgrade step.
   
   

   Tiki automatically detects that you are running an upgrade.
   
   

   Note: If the Tiki installer does not display the Upgrade link, confirm that the database information in your ...db/local.php file is correct.

4. On the Install & Upgrade page, click Upgrade to upgrade your Tiki database to the current release.
   
   

   Upgrading your database.
   
   

   Tip: In some cases, when a Tiki feature is deprecated or removed, there may be "extra" database tables that remain, after the upgrade. If you do not have any data these tables, you may safely remove them from the database. See http://doc.tiki.org/Upgrade for details of tables can be removed.

5. After upgrading the database, confirm that all queries were successful and click Continue.
   
   

   Completing the Installer upgrade.
6. Complete the remaining pages of the Tiki Installer, as needed, then enter your Tiki.

Be sure to read the Release Notes for each to understand the changes in the new release.

Restoring your Customizations

After completing your upgrade, you must restore any of the customizations that you previously backed up. This includes:

• Templates and stylesheets
• File galleries
• Attachments
• Language files
• Plugins and modules

Note: If you customized any PHP files that were part of the upgrade, you will have to manually copy your customizations to the new version files. To avoid this issue, consider joining the Tiki Community and contributing your customizations to the Tiki code repository.

---