computer-playbook/roles/docker-listmonk
2024-04-04 15:54:21 +02:00
..
tasks Restructured code and matrix rol 2024-01-19 15:12:18 +01:00
templates Removed obsolete version attribute 2024-04-04 15:54:21 +02:00
vars changed default postgres logic and optimized discourse postgres integration 2024-01-05 11:27:04 +01:00
README.md Added update instructions 2024-02-05 13:28:48 +01:00

Docker Listmonk Role

This role deploys the Listmonk application using Docker. Listmonk is a high performance, self-hosted newsletter and mailing list manager with a modern dashboard.

Prerequisites

  • Docker and Docker Compose should be installed on your system.
  • Make sure that the required ports are available and not used by other services.

Installation and Configuration

  1. Clone the Repository:

    • Ensure you have the latest version of this playbook from the repository.
  2. Configure Variables:

    • Set your desired configurations in vars/main.yml. This includes the path to your Docker Compose files and any other relevant variables.
  3. Run the Playbook:

    • Execute the ansible playbook to set up Listmonk.
  4. Initial Database Setup:

    • After the first setup, run the following command to initialize the Listmonk database:
      docker compose run --rm application ./listmonk --install
      
  5. Configure Reverse Proxy (Optional):

    • If you are using a reverse proxy, configure it as per your domain settings in the nginx-docker-reverse-proxy role.
  6. Start Services:

    • Use the following command to start Listmonk services:
      docker-compose -p listmonk up -d --force-recreate
      

Upgrade

docker compose run application ./listmonk --upgrade

Configuration Files

  • docker-compose.yml: Defines the Docker setup for Listmonk and its database.
  • config.toml: Contains the application settings including the database connection, admin credentials, and server settings.

Further Information

Dependencies

  • This role depends on nginx-docker-reverse-proxy for setting up a reverse proxy for Listmonk.

Developed with AI

This Docker Listmonk role was developed with assistance from ChatGPT, a conversational AI by OpenAI. The conversation and guidance provided by ChatGPT can be found here.