Automatic Update

This update method is only recommended for installations with modifications to core phpBB files. This package detects changed files automatically and merges in changes if needed.

A number of automatic update files are available, and you should choose the one that corresponds to the version of the board that you are currently running. For example, if your current version is 3.3.0 and you are updating to 3.3.1, you need the file.

  1. Make a backup of the original files

  2. Make a backup of the database

  3. Locally, perform for the following steps:

    1. Download the phpBB 3.3 Automatic Update archive

    2. Extract the install/ directory

    3. Extract the vendor/ directory

  4. On your web server, delete the vendor/ directory

  5. Upload the install/ directory

  6. Upload the vendor/ directory

  7. Run the updater:


    For large boards, you may wish to update the database 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.

    2. Click the Update tab

    3. Click Update

    4. Select "Update filesystem and database" and click Submit

    5. Depending on file ownership, there are several options available to perform this update:

      • Download modified files in an archive: This will generate an archive containing all of the updated files. After downloading it, you upload its contents to the server.

      • Update files via FTP (Automatic): You provide FTP credentials and file paths so that the server may FTP the files in place.

      • Update files via direct access (Automatic): If the web server has write permissions, the updater can write the changes directly to the files

      If there are conflicts, you will be prompted to resolve them.

    6. Click Update Files

    7. Click "Continue Update Process" to update the database

  8. Delete the install/ directory on the server