Documentation

Upgrading

Follow these instructions to update your current FluxBB installation from either 1.2.x, 1.3.x or 1.4.x to the latest version (1.5.x).

Upgrading from PunBB 1.2.x and 1.3.x is also supported.

IMPORTANT: Always make a backup of your forum before updating. While we obviously test FluxBB to the best of our ability it is hard to simulate every single situation, especially when sites are using languages none of us know. The update script does have potential to corrupt your database in the unlikely event that something goes wrong. For help on creating a backup see the backing-up section.

There are three main ways to update for forum, depending on how modified it is.

Overwriting files

The easiest option is to simply overwrite the old files with the new ones. While this is the easiest way to update, it is also the least flexible: any modifications you have made to files that you overwrite will be lost.

  1. Download the new files and decompress them.
  2. Upload the contents of the /upload/ directory, overwriting the existing files.
  3. If prompted, run db_update.php from the forum root directory and follow the on-screen instructions.

Using a patch file

If you have a heavily modified forum and simply overwriting the files isn't an option, you can chose to do the update using a patch file.

  1. Download the relevant patch file.
  2. Apply the patch file (instructions).
  3. If required (i.e. if you didn't perform the patch on the server), upload the files.
  4. If prompted, run db_update.php from the forum root directory and follow the on-screen instructions.

Manually making the changes

If for some reason you cannot use the patch file (e.g. if you have a heavily modified forum), you can also make the changes manually. Obviously this isn't a good idea for large changes, but for most releases this should be doable.

  1. Download the relevant changeset file.
  2. Manually make all the changes described in the changeset (more information below).
  3. If required (i.e. if you didn't perform the changes on the server), upload the files.
  4. If prompted, run db_update.php from the forum root directory and follow the on-screen instructions.

The changeset files are produced using a tool called hdiff.