Upgrading from 3.0 to 3.3



Upgrading to phpBB 3.3 will render previously installed MODifications and styles unusable. If you have a custom logo, it will need to be redone after the upgrade. See Knowledge Base: How to Change your Board Logo.

phpBB 3.3 is not compatible with 3.0 and most of the previous files will need to be removed prior to upgrading.

To upgrade, perform the following steps:

  1. Ensure that your server meets the requirements for running phpBB 3.3: Section 1.1, “Requirements”

  2. Make a backup of the original files

  3. Make a backup of the database

  4. Deactivate all styles except for prosilver

  5. Remove all MOD-related changes from the database. The Support Toolkit's Database Cleaner can be used for this.

  6. Set British English as the only language pack

  7. Download the phpBB 3.3 Full Package archive

  8. Extract the contents of the archive to your computer and open the phpBB3 directory

  9. Delete the following files from the package:

    • The config.php file

    • The files/ directory

    • The images/ directory

    • The store/ directory

  10. On your website, delete all files from your board EXCEPT for:

    • The config.php file

    • The files/ directory

    • The images/ directory

    • The store/ directory

  11. Upload the contents of the phpBB3 directory from your computer to your forum's directory. You may be prompted to overwrite the remaining files. If prompted to merge or overwrite directories, choose to merge them.

  12. Update the database:

    Tip

    For large boards, you may wish to update via the command line instead of using a web browser. From your board's root, execute the following command: php ./bin/phpbbcli.php db:migrate --safe-mode

    1. Using your web browser, visit install/ in your board's root. (e.g. http://www.example.com/yourforum/install)

    2. Click the Update tab

    3. Click the Update button

    4. Select "Update database only" and click Submit

    5. Wait for the progress bar to reach 100% and for a message indicating that the update has completed

  13. Delete the install/ directory

Note

Ensure that the root level .htaccess file is included in the upload. Some FTP clients do not show files whose names start with a period and you may need to enable the display of hidden files.

Note

If your board made use of language packs other than British English, you will need to download a version that is compatible with phpBB 3.3 from https://www.phpbb.com/languages/

Important

When uploading the 3.3 files to your server, do NOT overwrite your config.php.

Important

When backing up your files, ensure that your FTP client is in binary mode or transfers files without extensions in binary mode.

For more information, see: Knowledge Base: Transferring attachment files with Filezilla