Docker Compose

PdfDing offers compose files for installing PdfDing via Docker Compose with a sqlite or a postgres database. You find the files in the compose directory. Make sure to also take a look at Configuration for PdfDing's various configuration options before getting started. To start PdfDing run:

docker-compose -d -f compose/sqlite.docker-compose.yaml

If you do not know which compose file you should choose, pick sqlite.docker-compose.yaml as it easier for getting started:

sqlite.docker-compose.yaml

version: "3"

services:
  pdfding:
    container_name: pdfding
    image: mrmn/pdfding:latest
    volumes:
      - sqlite_data:/home/nonroot/pdfding/db
      - media:/home/nonroot/pdfding/media
    environment:
      - DEFAULT_THEME=${DEFAULT_THEME:-dark}
      - DEFAULT_THEME_COLOR=${DEFAULT_THEME_COLOR:-blue}
      - SECRET_KEY=${SECRET_KEY:-some_long_random_secret}
      # the domain where you want to access PdfDing, e.g. pdfding.com
      - HOST_NAME=${HOST_NAME:-127.0.0.1}
      # In production set the following values to True
      - CSRF_COOKIE_SECURE=${CSRF_COOKIE_SECURE:-FALSE}
      - SESSION_COOKIE_SECURE=${SESSION_COOKIE_SECURE:-FALSE}
    ports:
      - "8000:8000"

volumes:
  sqlite_data:
  media:

If everything completed successfully, the application should now be running and can be accessed at http://127.0.0.1:8000.

Tip

If you use selinux it might be necessary to add the :Z after the volumes, e.g. sqlite_data:/home/nonroot/pdfding/db:Z.