Docker Compose

This section describes how to setup Papermerge and related services using docker compose.

Each docker compose file is used here in combination with one environment file usually named .env.

Make sure you have both docker and docker compose installed.

This guide was tested with docker version 20.10.6 and docker-compose version 1.29.2.

Complete Stack in 2 minutes

This setup installs complete Papermerge DMS stack with all required services.

Save following docker-compose.yml file on your local computer.

Next, create .env file with following content:

DB_USER=postgres
DB_NAME=postgres
DB_PASSWORD=postgres
DB_HOST=db
DB_PORT=5432

REDIS_HOST=redis
REDIS_PORT=6379

SECRET_KEY=12345abcdxyz

SUPERUSER_USERNAME=admin
SUPERUSER_EMAIL=admin@example.com
SUPERUSER_PASSWORD=admin

Start Papermerge DMS using following docker compose command:

docker compose -f docker-compose.yml --env-file .env up

You can access Papermerge DMS user interface using a web browser like Firefox. Open your web browser and point it to http://localhost:16000 address:

../_images/papermerge-login.png

Figure 1. Sign in screen available at http://localhost:16000

Sign in using credentials configured with SUPERUSER_USERNAME and SUPERUSER_PASSWORD options in .env file.

../_images/papermerge-example.png

Figure 2. Papermerge example