History

Kevin Veen-Birkenbach 015794458e Removed obsolete version attribute		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

README.md

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

Clone the Repository:
- Ensure you have the latest version of this playbook from the repository.
Configure Variables:
- Set your desired configurations in vars/main.yml. This includes the path to your Docker Compose files and any other relevant variables.
Run the Playbook:
- Execute the ansible playbook to set up Listmonk.
Initial Database Setup:
- After the first setup, run the following command to initialize the Listmonk database:
```
docker compose run --rm application ./listmonk --install
```
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.
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

For detailed installation instructions and configuration options, visit the Listmonk Installation Documentation.
You can also find more information on the Listmonk GitHub Repository.

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.