Paperless‑ngx Docker Compose Setup with OCR

Описание и применение

Настройка Paperless‑ngx с Docker Compose: устранение трёх распространённых ошибок, настройка безопасного ключа, локализация OCR и безопасный доступ к веб‑UI.

Задача

The official Paperless‑ngx Docker Compose files leave three traps for new installs: a placeholder secret key that v3 refuses to start with, the web UI exposed on all interfaces before an admin account is created, and insufficient guidance on OCR languages.

Результат

The guide resolves three common pitfalls in the official Paperless‑ngx Docker Compose setup, enabling secure, localized OCR and a safe web exposure. It demonstrates full lifecycle operations including backup and upgrade.

Рабочий процесс

• Create directories ~/paperless/consume and ~/paperless/export and set umask 077
• Generate .env with COMPOSE_PROJECT_NAME, POSTGRES_PASSWORD, and PAPERLESS_SECRET_KEY
• Save the modified docker‑compose.yml with pinned image tags, port binding, and environment variables
• Create docker‑compose.env with USERMAP_UID, USERMAP_GID, and other Paperless settings
• Run docker compose up -d
• Open the web UI at http://127.0.0.1:8000 and create the first admin account
• Set PAPERLESS_OCR_LANGUAGE=deu+eng and PAPERLESS_OCR_LANGUAGES=pol in docker‑compose.env
• Drop files into ./consume or configure IMAP rules
• Export documents with document_exporter --passphrase
• Upgrade by changing image tags and running docker compose up -d

Доказательства

The official compose files get you running, but they leave three traps for a new install.

Источник

Start from the official docker-compose.postgres-tika.yml, pin every image tag, bind the port to 127.0.0.1:8000, and put a random PAPERLESS_SECRET_KEY and database password in a .env file.

Источник

Open the web UI right away. The first account you sign up with becomes the superuser.

Источник