Upgrade phpList

Before running the commands shown on this page, you should load the Bitnami stack environment by executing the installdir/use_APPNAME script (Linux and MacOS) or by clicking the shortcut in the Start Menu under “Start -> Bitnami APPNAME Stack -> Application console” (Windows). On OS X VMs, the installation directory is /opt/bitnami and OS X VM users can click the “Open Terminal” button to run commands. Learn more about the Bitnami stack environment and about OS X VMs.

It is strongly recommended to create a backup before starting the update process. If you have important data, create and try to restore a backup to ensure that everything works properly.

You can upgrade the application only without modifying any other stack components. Follow these steps:

  • Backup the configuration file at installdir/apps/phplist/htdocs/config/config.php, together with any installed plugins.

  • Backup your current phpList database.

    $ installdir/mysql/bin/mysqldump -u root -p bitnami-phplist > ~/phplist.sql
  • Remove the application directory:

    $ rm -r installdir/apps/phplist/htdocs
  • Download the latest version of phpList.

  • Decompress the downloaded file and copy the public_html/lists directory to the phplist/ directory.

    $ tar xvf phplist-X.X.X.tar.gz
    $ cp -r phplist-X.X.X/public_html/lists installdir/apps/phplist/htdocs
  • Recover the previous configuration by copying the configuration file you backed up earlier to * installdir/apps/phplist/htdocs/config/config.php*.

    $ cp config.php installdir/apps/phplist/htdocs/config/config.php
  • Browse to the application home page, and you should see a message telling you that the database is out of date. To correct this, click the upgrade link on the page.

Last modification April 8, 2020