nativeInstallerphplist

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.

NOTE: The Approach A sections referred to below do not apply to Bitnami native installers. Users of Bitnami native installers should refer only to the Approach B sections.

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 the steps below depending on your installation type:

Approach A: Bitnami installations using system packages

  • Backup the configuration file at installdir/phplist/config/config.php.

  • Backup your current phpList database.

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

      $ rm -r installdir/phplist/
    
  • 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/phplist/
    
  • Recover the previous configuration and data folders by copying the configuration file you backed up earlier to installdir/phplist/config/config.php.

      $ cp config.php installdir/phplist/config/config.php
      $ rm -r installdir/phplist/admin/plugins
      $ ln -s /bitnami/phplist/admin/plugins installdir/phplist/admin/plugins
      $ rm -r installdir/phplist/images/image
      $ ln -s /bitnami/phplist/images/image installdir/phplist/images/image
    
  • 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.

Approach B: Self-contained Bitnami installations

  • Backup the configuration file together with any installed plugins and uploaded images:

    • installdir/apps/phplist/htdocs/config/config.php
    • installdir/apps/phplist/htdocs/admin/plugins
    • installdir/apps/phplist/htdocs/images/image
  • 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 June 16, 2021