How To Set Up PHPList

From OpenLiteSpeed Wiki

In the following article we will guide you through the steps to install phpList, an open source mailing list management system written in PHP. (Detailed phpList installation instructions can be found at

Install phplist

1. Install PHP

The easiest way to install PHP for OpenLiteSpeed is through our CentOS repository. If the LiteSpeed Repository was not installed and enabled during the web server installation, follow this guide to install and enable the LiteSpeed Repository.

Use the following command to install PHP with the modules required:

yum install lsphp55 lsphp55-common lsphp55-gd lsphp55-process lsphp55-mbstring lsphp55-mysql lsphp55-imap
Note: There are four versions of LSPHP (lsphp53, lsphp54, lsphp55, lsphp56) available.

Direct LSWS to the location of the installed PHP. (In this example, PHP 5.5 is installed by default in /usr/local/lsws/lsphp55/bin/lsphp. Change the value of the WebAdmin console > External App > your external application > Command setting to reflect that.)

If you are not using RedHat or CentOS, or you prefer to build PHP by yourself, see our instructions for building PHP for phpList here.

2. Download phpList (the latest version is 2.10.19 as of writing) into your virtual host document root: /usr/local/lsws/test1/html

cd /usr/local/lsws/test1/html
tar zxf phplist-2.10.19.tgz
cp -rp phplist-2.10.19/public_html/lists .
rm phplist-2.10.19 phplist-2.10.19.tgz

3. Set up a MySQL database and user for phpList.

yum install mysql mysql-server
service mysqld start
mysql -u adminusername -p
mysql> create database phplist
mysql> grant all privileges on phplist.* to db_user@'localhost' identified by 'password'

4. Graceful restart to apply changes. (Actions > Graceful Restart)

5. Point your browser to http://localhost:8088/lists/admin/index.php to run the phpList installer.

For a detailed configuration guide, go to

6. Once you have completed, your newly installed phpList will be accessible from http://server_ip:8088/lists/.