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

Конспект страницы: 7 разделов коротко, данные на 14 октября 2026 и ответы на 4 вопроса. Полный разбор с примерами: Paperless-ngx в Docker: установка на свой сервер.

Коротко

Главная / Self-hosted / Paperless-ngx Paperless-ngx в Docker ставится установочным скриптом или готовым docker-compose для вашей базы данных: веб-интерфейс открывается на порту 8000, а новые документы берутся из папки consume. Это домашний архив бумаг: сканы и PDF распознаются, получают метки и находятся полнотекстовым поиском, даже если в имени файла написано scan_0042. Для начала возьмите 2 ядра и 2-4 ГБ памяти: основную работу делает OCR на процессоре.

Конспект по разделам

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

Paperless-ngx это система учёта документов с открытым кодом. Вы кладёте в папку скан договора или счёта, программа распознаёт текст, определяет автора, тип и метки и сохраняет файл вместе с поиском по содержимому. Оригинал остаётся нетронутым, рядом создаётся копия в формате PDF/A для долгого хранения.

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

Документация не называет минимальную конфигурацию. Она сообщает только, что Paperless-ngx работает на Linux, для установки через Docker нужны Docker и Docker Compose, а запускается он в том числе на Raspberry Pi. Поэтому рассчитывайте от самой тяжёлой операции: распознавания текста.

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

Ручной путь: из репозитория скачивают один файл docker-compose.*.yml под выбранную базу, сохраняют его как docker-compose.yml и добавляют рядом docker-compose.env и.env. Файлы со словом tika в названии добавляют разбор документов Office. Порт по умолчанию 8000, его меняют в строке вида 8010:8000.

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

Из коробки Paperless-ngx распознаёт английский. Для русского нужны две строки в docker-compose.env: язык распознавания и пакет языка в контейнере. PAPERLESS_OCR_LANGUAGE указывает языки документов через плюс, первым пишут основной.

Как документы попадают в Paperless-ngx: папка consume, почта и сканер

Папка на сервере примонтирована в контейнер как /usr/src/paperless/consume. Всё, что в неё попадает, обрабатывается и пропадает из папки, оставаясь в архиве. Положить файлы в неё можно несколькими способами.

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

Для копий в Paperless-ngx есть отдельная команда: экспортёр сохраняет документы вместе с метаданными в папку export, откуда её забирают на другой сервер или в S3. Копия базы одного PostgreSQL без файлов бесполезна, а копия файлов без базы теряет метки и правила. Схему хранения копий описывает страница про бэкапы.

Запустите свой сервер за пару минут

Почасовая оплата: тестовый стенд на сутки стоит десятки рублей, а не месячный тариф.

Вопросы и ответы

Как установить Paperless-ngx через Docker?

Запустите установочный скрипт из репозитория: он задаст вопросы, создаст файлы, скачает образ и заведёт администратора. Или скачайте docker-compose.yml под свою базу и docker-compose.env вручную.

Как включить русский язык OCR в Paperless-ngx?

В docker-compose.env задайте PAPERLESS_OCR_LANGUAGE=rus+eng и PAPERLESS_OCR_LANGUAGES=rus, затем пересоздайте контейнеры. Вторая переменная устанавливает пакет языка.

Какой порт у Paperless-ngx?

8000. В docker-compose.yml его меняют строкой вида 8010:8000, а за обратным прокси открывают по домену с HTTPS.

Как сделать резервную копию Paperless-ngx?

Команда document_exporter сохраняет документы и метаданные в папку export. Её копию храните на другом сервере или в S3 отдельно от основной машины.