This is the official one docker image for Lago.

This docker image is designed for testing and staging environments only. It is not recommended for production use due to its simplified architecture and resource constraints. For production deployments, please refer to our deployment guides in the deploy folder or use our helm chart for a more robust and scalable setup.

This docker image embed everything to run Lago with just one command line to ease the deployment. Here are the services that are running into the container :

• PostgreSQL
• Redis
• Lago UI
• Lago API
• Lago Worker
• Lago Clock
• PDF Service (optional)

docker run -d --name lago -p 80:80 -p 3000:3000 getlago/lago:latest

PDF generation is disabled by default. We use Gotenberg, which is only available as a Docker image. To enable PDF generation, use the following command:

docker run -d --name lago -v /var/run/docker.sock:/var/run/docker.sock -p 80:80 -p 3000:3000 getlago/lago:latest

You will see an other docker container named lago-pdf running.

You can use external services for the database and Redis instance. Here are the env var you should pass to the container to use them :

The container is using a volume to store the data, you can mount it to your host to keep the data safe. You can find many folders for each services in the /data folder.

SSL is disabled by default in this development/staging image. To enable SSL support when using a proxy or load balancer:

For new installations:

• Add the environment variable LAGO_DISABLE_SSL=false when running the container

  docker run -e LAGO_DISABLE_SSL=false ...

For existing installations:

• Navigate to your /data volume
• Edit the .env file to change LAGO_DISABLE_SSL=true to LAGO_DISABLE_SSL=false

⚠️ Note that this only enables SSL support - you must still configure SSL certificates and termination through your reverse proxy or load balancer.

Database Logs (creation, migration) are stored in the /data/db.log file. Applicative logs are streamed to the standard output.

This docker image is a work in progress. Feel free to open issues or PRs to improve it or ask for new features.