Upgrades follow a very similar procedure to new installations, you simply need to upload the files and then follow the on-screen instructions.

You may upgrade from any previous version to the latest version directly.
You do not need to upgrade to interim versions first.

Before starting an upgrade, we recommend that you backup your XenForo database and files. This is especially important if you have installed third-party add-ons and are performing a major upgrade.

1. Downloading

First, download the latest version of XenForo from the XenForo Customer Area.

  1. Click the Download XenForo link next to the license/site you are upgrading.
  2. Before you download the file, ensure that Download the upgrade package only is selected.
  3. Save the file to your computer.

2. Uploading

Example FTP clients:

At this point you will need an FTP client and FTP login credentials for your server. If you don't know these, your hosting provider will be able to assist you.

  1. Connect to your server using the FTP client and navigate to the directory where XenForo is installed.
  2. Unzip the file that you downloaded in step 1 and you will see an upload directory within it.
  3. It is important that the files on the server and what you're uploading are "merged". Otherwise you may lose some files and data.
    Upload the contents of this directory to your server, over top of your existing XenForo files. This can often be done by dragging the contents of the folder (including all sub-folders) into the server's window in your FTP client.
  4. You should be prompted to confirm that you want to overwrite the existing files; you must do this.
  5. The upload may take a significant amount of time.
  6. Your board will automatically be closed after the files are uploaded.

Note that you generally do not need to set permissions like when doing a new installation; the existing permissions will be preserved.

3. Upgrading

Once the new files are uploaded, you need to complete the upgrade.

  1. Point your browser at the install directory within your XenForo URL (e.g., www.example.com/community/install/).
  2. You may be prompted to login using your administrator's user name and password.
  3. Follow the on-screen instructions until the upgrade is completed.

Once the upgrade has finished, your board will be re-opened.

If the upgrade system says that you are already running the most recent version, repeat the Uploading step, as the files were not overwritten correctly. Ensure that you are in the correct place and that correct files are being overwritten.

4. Post-Upgrade Checks

After you complete an upgrade, you should ensure that your template and phrase modifications are up to date.

  1. Log in to the XenForo admin control panel.
  2. Click on the Appearance tab.
  3. Look at the Outdated Templates and Outdated Phrases pages.

We currently recommend that you revert any outdated templates or phrases, and redo your customizations. Alternatively, in XenForo 1.2, you can use the template merging options to quickly update your template edits.

You should also confirm the integrity of all uploaded files.

  1. Log in to the XenForo admin control panel.
  2. Click on the Tools tab.
  3. Click on File Health Check from the list on the left hand side.

This tool will confirm whether all the appropriate files are in place and contain the correct contents. If any problems are detected, you will be alerted to the error.