Jump to content


[GUIDE] PHPList Installation and Configuration

  • This topic is locked This topic is locked
No replies to this topic

#1 Cryo Kinesis

Cryo Kinesis

    Haphost Staff

  • Moderators
  • 128 posts
  • LocationGridania, Eorzea

Posted 05 August 2014 - 04:40 PM

Hi there,


1.1 What is phpList?
phplist is an open-source mailing list manager. It is written in PHP and uses a MySQL database for storing information.
The software runs on a web server and allows web site administrators to set up a web based newsletter subscription system where users can subscribe to the desired mailing lists.
It allows email messages to be sent out to a large number of subscribers and also allows email message templates to be set up (e.g. for a consistent look and feel). It also allows the email messages being sent out to be personalised with attributes that are unique to each subscriber.

1.2 Requirements
phplist is developed and tested with the following server software:
* GNU/Linux
* Apache web server
* MySQL database server version 4.0 or higher
* PHP versions 4.3.x or higher (IMAP module required for bounce processing)
phplist also runs on PHP 5, MySQL 4.1 & 5.
The developers use the following setup:
* A recent release of any Linux distribution
* Mysql 5.0.27
* PHP 5.2
phplist also runs on windows, with Apache, PHP and MySQL.


1.3 How to install phpList on my account?

You can easily install phpList using Softaculous application installer.
1. Login to DirectAdmin server control panel.
2. Locate Softaculous Application Installer.
3. Pick up phpList from the application list.
4. Follow the installation wizard which will ask you to enter important information which is required to installation.

1.4 How to upgrade my PHPList site?
1. If you’re using phpMyAdmin you can follow these steps to make a full backup of your database:
2. Copy your old configured files to a safe place.

* These files are:

– lists/config/config.php
– lists/texts/english.inc, or any other language.inc file if you have customized these
– lists/.htaccess, if you have customized it and want to keep it for reference.
– any plugins you may have been using
If you want to be on the safe side, we recommend you download the contents of the phpList directory from your web server to your hard disk. Should things go wrong, you can simply restore these files to the server.
3. Now you can delete your old phpList installation and replace it with the new version

* Download the latest phpList release marked as stable from the phpList website

* The file is a either a .zip or .tar.gz archive, which means you need to unpack it with a program like Winzip, 7zip or Winrar. Make sure you let it re-create (sub)directories.
* Delete all from your online phpList folder (make sure you stored your config.php file, and your customized english.inc or language.inc files).
* Upload the contents of the phpList directory (i.e. the “lists” directory) to your online phpList folder.
4. Then adapt your config.php file. You could overwrite the config file with the config file you stored earlier, but it is strongly recommended to use the new config.php file and re-adapt it to your situation by using the settings specified in your old config file, because new features may have have been added.
5. Finally point your browser to your phpList admin directory and login. You’ll be notified that your database is out of date. 

(i.e.: “Your database is out of date, please make sure to upgrade”)

Just click on the upgrade link in the System Functions block.
6. When you made sure you have a database backup, click the link in the next page to start the upgrade process of your database tables.
Your phpList is now upgraded.

1.5 How to reset my PHPList administrator password?
In case you have forgotten your password, go to the administrative login screen and you will see a field named:

Forgot Password?: Enter your email:.

There you will have to enter the email address associated with the administrative username and an email with the password will be sent to that address.


0 user(s) are reading this topic

0 members, 0 guests, 0 anonymous users