mirror of https://github.com/nickyeoman/docker-compose-cookbooks.git synced 2026-09-03 18:36:22 +00:00

Files

T

codeandClaude Fable 5 8ab413804a normalize all stacks to conventions

- VOL_PATH always defaults to /data; vscode/opencode VOL_PROJECTS nests it
- TZ defaults to America/Vancouver (was UTC in etherpad, ntfy, redis)
- compose section order fixed (volumes before environment, command after networks)
- all default secrets are the literal ChangeThisPassword (grep-friendly,
  users must change them); removed a real key from ollama sample.env
- sample.env synced with compose: missing vars added with defaults, dead vars removed
- invoiceninja_dev/openarchiver_dev: app services had no environment block,
  wired all sample.env vars through so the stacks actually work
- opencode: sample.env OLLAMA_HOST renamed to OLLAMA_HOST_URL to match compose
- TZ values unquoted consistently

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-16 06:24:54 +00:00

compose.yaml

normalize all stacks to conventions

2026-07-16 06:24:54 +00:00

README.md

cleaned up and updated paperless

2026-04-22 22:42:57 +00:00

sample.env

normalize all stacks to conventions

2026-07-16 06:24:54 +00:00

README.md

Paperless

Project Details

Project Repository: Link
Container Image: Github
Compose Example: Compose
Documentation: Docs
Reverse Proxy Port: 8000

First Run

It takes a very long time for the first run to initilaze, v view the log to see when it's ready.

The ui will now create the first user for you, but we used to have to run:

docker exec -it paperless-ngx bash
python3 manage.py createsuperuser

Configuration

All settings are controlled via environment variables in your .env file. Key variables include:

Variable	Default	Description
`PAPERLESS_IMAGE`	`ghcr.io/paperless-ngx/paperless-ngx:latest`	Paperless Docker image
`PAPERLESS_MARIADB_HOST`	`paperless-db`	MariaDB host
`PAPERLESS_MARIADB_DATABASE`	`paperless`	Database name
`PAPERLESS_MARIADB_USER`	`paperless`	Database user
`PAPERLESS_MARIADB_PASSWORD`	`paperless`	Database password
`PAPERLESS_MARIADB_ROOT_PASSWORD`	`paperless`	MariaDB root password
`PAPERLESS_SECRET_KEY`	`changeme`	Secret key for Paperless
`PAPERLESS_OCR_LANGUAGE`	`eng`	OCR language for scanned documents
`VOL_PATH`	`./data`	Base path for volume storage
`TZ`	`America/Vancouver`	Timezone

You can adjust these values in your .env (drived from sample.env) file before starting the containers.

For the full list of available options, see the Paperless-ngx configuration documentation.