Knowledge Base

How to install phpList using Softaculous

This article describes how to install phpList, a newsletter manager, using the Softaculous installer in cPanel.

Installing phpList

You can get phpList up and running on your web site in minutes by using the Softaculous application installer in cPanel.

To install phpList using Softaculous, follow these steps:

  1. Log in to cPanel.
    If you do not know how to log in to your cPanel account, please see this article.
  2. In the Software/Services section of the cPanel home screen, click Softaculous. The Softaculous installer page appears.
  3. In the Search text box, type phplist and then press ENTER.
    Alternatively, you can use the navigation pane on the left side. To do this, click Mails, and then click phpList.
  4. Click Install. The installation page appears.
  5. In the Choose Protocol list box, select the protocol.
    If you have an SSL certificate installed on your site, select https:// or https://www. If you do not have an SSL certificate installed on your site, select http:// or http://www.
  6. In the Choose Domain list box, select the domain for installation, or accept the default value.
  7. In the In Directory text box, type the directory where you want to install the application, or accept the default value.
    If you want your domain name to go directly to the application, make sure the In Directory text box is blank.
  8. In the Database Name text box, type the name of the database to create for the application, or accept the default value.
  9. In the CRON Job text boxes, type the cron job intervals, or accept the default values.
    Cron jobs are tasks that are scheduled to run automatically. If you are unsure of the values you should use, accept the default values.
  10. In the Site Name text box, type the site name.
  11. In the Table Prefix text box, type the database table prefix, or accept the default value.
  12. In the Admin Username text box, type the administrator username.
  13. In the Admin Password text box, type the administrator password.
    Make sure that you choose a strong password! The Softaculous installer provides a ranking for your password's strength, and turns green when the password is strong. Alternatively, you can click the Random Password icon icon next to the Admin Password text box, and Softaculous generates a strong, random password for you.
  14. In the Real Name text box, type the display name for the administrator.
  15. In the Admin Email text box, type the site administrator e-mail address.
  16. Click the Advanced Options icon icon to expand Advanced Options.
  17. If you do not want to receive e-mail notifications when application updates are available, select the Disable Update Notifications check box.
    A2 Hosting strongly recommends that you receive e-mail notifications when application updates are available. Keeping your site updated helps prevent unauthorized access attempts and data loss.
  18. To receive site configuration information after the installation is complete, type an e-mail address in the Email installation details to text box.
  19. Review the installation options and settings, and then click Install. When installation is complete, Softaculous provides information about the application's configuration.

Configuring phpList

A2 Hosting servers allow you to send a maximum of 500 e-mail messages per hour per account. Therefore, if you have a mailing list with more than 500 subscribers, you must make some modifications to phpList's sending configuration. To do this, follow these steps:

  1. Use the File Manager in cPanel to locate the phpList configuration file:
    • If you installed phpList in the default directory, the configuration file is located at /home/username/public_html/phplist/config/config.php.
    • If you installed phpList in the web root (public_html) directory, the configuration file is located at /home/username/public_html/config/config.php.
  2. In the cPanel File Manager, open the config.php file for editing. If you are unfamiliar with the editors in cPanel's File Manager, please see this article.
  3. Locate the section in the config.php file named batch processing. You should see the following code:

    # define the amount of emails you want to send per period. If 0, batch processing
    # is disabled and messages are sent out as fast as possible
    define("MAILQUEUE_BATCH_SIZE",0);
    
    # define the length of one batch processing period, in seconds (3600 is an hour)
    [Note: Some text omitted for brevity]
    
    define("MAILQUEUE_BATCH_PERIOD",100);
    
  4. To prevent your account from sending more than 500 e-mail messages in an hour, we recommend using the following settings. These settings limit phpList to sending 400 messages an hour:

    # define the amount of emails you want to send per period. If 0, batch processing
    # is disabled and messages are sent out as fast as possible
    define("MAILQUEUE_BATCH_SIZE",400);
    
    # define the length of one batch processing period, in seconds (3600 is an hour)
    [Note: Some text omitted for brevity]
    
    define("MAILQUEUE_BATCH_PERIOD",3600);
    
  5. Save your changes to the config.php file.

More Information

For more information about phpList, please visit http://www.phplist.com.