Installing phpList manually
This chapter explains how to manually install phpList. You may wish to install it using an automated tool if one is available to you. See the auto-installation chapter for more information on this.
Overview of phpList installation
phpList lives in its own folder called "lists." Manual installation follows these steps:
- Download phpList
- Unzip phpList
- Upload to your server using FTP
- Local Windows installation
- Create a database
- Add the database details to the config.php file
- Configure using web interface.
First check that your server meets the System Requirements. Then download the latest version of phpList from http://www.phplist.com/download by clicking either Download ZIP or Download TGZ.
Once you have downloaded phpList to your computer, unpack it to a temporary folder. You can usually do this by right clicking and choosing Extract Here (Linux, as in screenshot), double clicking the folder (mac) or right click "extract all" (Windows).
Upload to your server using FTP
Start your favourite FTP program, in this case we are using FileZilla.
Browse through to your temporary folder in the FTP program, then open the public_html folder to find the lists folder.
Upload this /lists folder into your public_html file on your server. This folder may have lots of files in it already. In the image below you can see the public_html folder on the server contains folders for a WordPress site.
Grab a Coffee!
This upload may take some time, you may even have to split it over a number of partial uploads depending on your connection speed, time outs and upload limits.
Local Windows installation
If you do not own a server or you want to develop locally, you can also install phpList on your Windows machine. First, you need to download the XAMPP package and install it in your PC. After installing, copy the /lists folder as stated in the previous section and paste it in the htdocs folder of XAMPP.
Next up, you must run the XAMPP Control Panel and start the Apache and MySQL server. Now we are ready to create a database for phpList on which to save the data.
Create a database using your control panel
Once you have uploaded the /lists directory, go to your hosting control panel or to the localhost from your browser and create a database. If you need help, your web hosting company can help you with this.
Whatever the process, you will always end up with three things:
- A database name, for example cl52-phplist
- A database username, for example phplist
- A password for your database, for example T!LcDaM/4
An example of creating a database
These screenshots provide an example. This may or may not be similar to the way you can create a new database on your server. That depends entirely on which software your hosting company uses.
First click MySQL Databases.
Then type in the new database name (we used the name phpList) and enter or generate a strong password. Make sure you keep a copy of these details!
This system creates a user automatically, where the username is the same as the database name (a common preference). In other software you may need to add a new user separately and you may also need to allocate this user to your database.
Your database is now ready. Copy down the details because you will need them in a moment.