Upgrade Typo with Typo installer

This works even if you haven't installed your Typo instance with the installer as long as you have the Typo gem installed on your system. If you haven't, check how to Install Typo with Typo installer.

Before you get started, make sure you meet the minimum requirements.

Three Step Upgrade

For these instructions, it is assumed that your blog's URL is http://example.com. Note that during the upgrade process access to your blog may not work for your visitors.

Step 0: Before You Get Started

Make sure the database user name registered to Typo has permission to create, modify, and delete database tables. If you installed Typo in the standard way, and nothing has changed since then, you are fine.

Deactivate your sidebar plugins. A plugin might not be compatible with the new version, so it's nice to check for new versions of them and deactivate any that may cause problems. You can reactivate plugins one-by-one after the upgrade.

Backup your public/ and your themes/ directories. If you're using one of the defaults themes, they will be overriden with files from your new Typo version.

Step 1: Replace Typo files

Get the latest Typo gem.

  sudo gem update

If you don't have root access on your hosting server, then try this instead:

  export GEM_PATH=~/gems
  gem update

Step 2: Upgrade your installation

We couldn't find an easiest way to upgrade your installation.

  typo install /path/to/your/current/typo/installation

If you don't have root access on your hosting server and Typo is not installed system wide, then try this instead:

  ~/gems/bin/typo install /path/to/your/current/typo/installation

Typo will backup your database for you and upgrade itself, even if it was not installed with the installer

Restart your Typo application, and you're done.

Step 3: Set things back to normal

Enable your plugins back.

If you have caching enabled, your changes will appear to users more immediately if you clear the cache at this point (and if you don't, you may get confused when you see the old version number in page footers when you check to see if the upgrade worked).

Your Typo installation is successfully upgraded. That's as simple as we can make it.

Consider rewarding yourself with a blog post about the upgrade, reading that book or article you've been putting off, or simply sitting back for a few moments and let the world pass you by.