Getting started with phpList is designed to be straightforward, giving organizations and individuals a powerful open-source platform to manage mailing lists and deliver email campaigns at scale. The setup process begins with downloading and installing phpList on your server, followed by configuring essential details such as database connections, administrator accounts, and domain settings. Installation is flexible, supporting a variety of hosting environments, and integrates seamlessly with your existing infrastructure. By completing these steps, you’ll establish a secure and customizable foundation that empowers you to build, send, and track professional email communications from the very start.
 
Declutter your email and reduce distractions using Clean Email →
 

phpList Installation Process

Using phpList Effectively

  1. Check System Requirements

    • Ensure your server supports:

      • PHP (latest stable version recommended)
      • MySQL or MariaDB
      • Apache or Nginx

    • Recommended: Linux-based hosting with FTP access
  2. Download phpList

    • Visit the official download page

    • Choose the latest version (ZIP or TGZ format)
  3. Unzip the Package

    • Extract the downloaded archive to a temporary folder:

      • Windows: Right-click → “Extract All”
      • macOS: Double-click the archive
      • Linux: tar -xvzf filename.tgz or use GUI
  4. Upload to Your Server

    • Use an FTP client (e.g. FileZilla) to upload the /lists folder to your server’s public_html or equivalent directory
  5. Create a MySQL Database

    • Log into your hosting control panel (e.g. cPanel)

    • Create a new database and user

    • Note down:
      • Database name
      • Username
      • Password
      • Host (usually localhost)
  6. Configure phpList

    • Navigate to /lists/config/config.php

    • Update the following lines with your database info:

    php
    $database_host = “localhost”;
    $database_name = “your_db_name”;
    $database_user = “your_db_user”;
    $database_password = “your_db_pass

  7. Set Permissions

    • Ensure the web server can read/write necessary files:

    bash
    chown -R www-data:www-data /var/www/lists
    find /var/www/lists -type d -exec ch

  8. Access the Web Installer

    • Go to http://yourdomain.com/lists/admin

    • Follow the on-screen setup wizard to:
      • Set admin credentials
      • Configure sending options
      • Customize your subscription page
  9. Optional: Local Installation (Windows)

    If you’re testing locally:

    • Install XAMPP

    • Copy /lists folder into htdocs

    • Start Apache and MySQL via XAMPP Control Panel

    • Create a database via localhost/phpmyadmin

    • Access phpList via http://localhost/lists/admin
  10. SSL Setup (Optional but Recommended)

    For secure access:

    • Use Let’s Encrypt to generate an SSL certificate

    • Configure your web server (Apache/Nginx) to serve https://yourdomain.com/lists