This guide provides a full Ansible playbook to deploy phpList with Docker Compose on Debian 10+, Ubuntu LTS, and RHEL 9+ compatible hosts.
phplist.example.com)- name: Deploy phpList
hosts: phplist
become: true
vars:
app_root: /opt/phplist
app_port: 8080
db_password: "ChangeMe123!"
db_root_password: "RootChangeMe123!"
admin_email: "admin@example.com"
admin_password: "AdminChangeMe123!"
phplist_domain: "phplist.example.com"
phplist_version: "latest"
tasks:
- name: Install Docker on Debian/Ubuntu
apt:
name:
- docker.io
- docker-compose-plugin
state: present
update_cache: true
when: ansible_os_family == "Debian"
- name: Install Docker on RHEL family
dnf:
name:
- docker
- docker-compose-plugin
state: present
when: ansible_os_family == "RedHat"
- name: Enable and start Docker
service:
name: docker
state: started
enabled: true
- name: Create application directory
file:
path: "{{ app_root }}"
state: directory
mode: "0755"
- name: Write Docker Compose file
copy:
dest: "{{ app_root }}/docker-compose.yml"
mode: "0644"
content: |
services:
phplist:
image: phplist/phplist3:{{ phplist_version }}
container_name: phplist
restart: unless-stopped
ports:
- "{{ app_port }}:80"
environment:
- DB_HOST=db
- DB_NAME=phplist
- DB_USER=phplist
- DB_PASSWORD={{ db_password }}
- ADMIN_EMAIL={{ admin_email }}
- ADMIN_PASSWORD={{ admin_password }}
- DOMAIN={{ phplist_domain }}
volumes:
- phplist_data:/var/www/html
depends_on:
- db
db:
image: mariadb:10.11
container_name: phplist-db
restart: unless-stopped
environment:
- MYSQL_ROOT_PASSWORD={{ db_root_password }}
- MYSQL_DATABASE=phplist
- MYSQL_USER=phplist
- MYSQL_PASSWORD={{ db_password }}
volumes:
- db_data:/var/lib/mysql
volumes:
phplist_data:
db_data:
- name: Start application stack
command: docker compose up -d
args:
chdir: "{{ app_root }}"
phplist/phplist3 on Docker Hublatesthttp://your-server:8080Any questions?
Feel free to contact us. Find all contact information on our contact page.