Paperless-ngx в Docker: установка на свой сервер, термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Paperless-ngx в Docker: установка на свой сервер». Страница справочника целиком: Paperless-ngx в Docker.

Коротко о теме

Paperless-ngx в Docker: установочный скрипт или docker-compose, образ ghcr.io/paperless-ngx, папка consume, русский OCR через переменную PAPERLESS_OCR_LANGUAGE.

Подробности по разделам

Что делает Paperless-ngx и чем он отличается от папки со сканами

От папки с файлами это отличается поиском по словам внутри сканов и правилами: счета от одного поставщика получают одни метки и один тип автоматически. Для общих файлов компании и совместной работы подходит Nextcloud, а Paperless-ngx отвечает за архив бумаг. Работать с самими PDF (склеить, сжать, поставить пароль) удобнее в Stirling PDF.

Сколько ресурсов нужно Paperless-ngx

OCR держит ядра занятыми, пока обрабатывается каждая страница, поэтому важнее число ядер, чем память. Диск растёт вместе с архивом: оригинал, копия PDF/A и миниатюры занимают места больше, чем один исходный скан. Сколько документов и как часто вы их загружаете

Установка Paperless-ngx через скрипт и docker-compose

За прокси укажите адрес в переменной PAPERLESS_URL: Caddy получит сертификат на домен сам. Ключ PAPERLESS_SECRET_KEY нужно задать длинным случайным значением, иначе третьи лица смогут подделывать данные для входа.

OCR на русском в Paperless-ngx: PAPERLESS_OCR_LANGUAGE и языковые пакеты

PAPERLESS_OCR_LANGUAGES устанавливает пакет Tesseract в контейнер при старте. Без второй строки русский язык в списке есть, а файлов языка нет, и распознавание не заработает. Качество зависит от скана: при 300 dpi и ровной странице результат заметно лучше, чем у фото с телефона под углом.

Копии и обновление Paperless-ngx в Docker

Перед обновлением читайте руководство по миграции Документация предупреждает, что переход с версии 2 на версию 3 содержит несовместимые изменения. Сделайте экспорт, прочтите руководство для вашей версии и только потом меняйте образ командами docker compose pull и docker compose up -d.

Ключевые цифры

В docker-compose.yml его меняют строкой вида 8010:8000, а за обратным прокси открывают по домену с HTTPS.
Её копию храните на другом сервере или в S3 отдельно от основной машины.
Источники цифр на этой странице: VPS и VDS серверы Таймвеб Клауд, timeweb.cloud/services/vds-vps, проверено 14 октября 2026; Маркетплейс приложений Таймвеб Клауд, timeweb.cloud/marketplace, проверено 14 октября 2026; Документация Paperless-ngx: установка (setup), docs.paperless-ngx.com/setup, проверено 15 октября 2026.

Термины на странице

S3: S3 это объектное хранилище файлов с доступом по API, совместимому с Amazon S3.
Linux: Linux это семейство операционных систем для серверов: Ubuntu, Debian, AlmaLinux и другие.
Nextcloud: Nextcloud это облачное хранилище файлов, которое ставят на свой сервер.
PostgreSQL: PostgreSQL это база данных для приложений с большими объёмами и сложными запросами.
SFTP: SFTP это передача файлов поверх SSH: шифрует и данные, и пароль.
SSH: SSH это защищённое подключение к серверу через командную строку. Вход по ключу безопаснее, чем по паролю.
Self-hosted: Self-hosted значит, что программа работает на вашем сервере, а данные остаются у вас.

Что проверить

Храните данные контейнеров в томах.
Закрепляйте версии образов, а не latest.
Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.
Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.