Установка Paperless-ngx с использованием Docker Compose

Paperless-ngx — это современная система управления документами, которая позволяет сканировать, индексировать и хранить бумажные документы в цифровом виде. Для установки Paperless-ngx рекомендуется использовать Docker Compose с официальным контейнером.

Требования

• Операционная система: Linux (рекомендуется Ubuntu или Debian).
• Доступ к Docker и Docker Compose.
• Свободное место на диске для хранения сканированных документов.

Шаги установки

1. Установите Docker и Docker Compose: Следуйте официальной документации по установке Docker на вашу систему. После установки проверьте версию с помощью команды docker --version и docker-compose --version.
2. Создайте каталог для конфигурации: Создайте папку, например, /opt/paperless-ngx, где будут храниться файлы конфигурации и данные.
3. Создайте файл compose.yaml: В созданной папке создайте файл compose.yaml с содержимым ниже.
4. Запустите контейнер: Используйте команду docker-compose up -d, чтобы запустить Paperless-ngx в фоновом режиме.
5. Проверьте статус контейнера: Убедитесь, что контейнер работает корректно с помощью команды docker ps.
6. Первый вход: Откройте браузер и перейдите по адресу http://localhost:8000, чтобы получить доступ к интерфейсу Paperless-ngx.
7. Обновление: Для обновления системы используйте официальный релиз из GitHub. Остановите контейнер, удалите старую версию и запустите новую с помощью docker-compose up -d.
8. Резервное копирование: Регулярно создавайте резервные копии данных из папки /opt/paperless-ngx/data и базы данных.
9. Безопасность: Убедитесь, что Paperless-ngx запускается на доверенном хосте. Используйте HTTPS для защиты данных в транспорте.
10. Устранение ошибок: Если возникают проблемы, проверьте логи контейнера с помощью docker logs paperless-ngx.

Пример compose.yaml

version: '3.8'
services:
  paperless-ngx:
    image: ghcr.io/paperless-ngx/paperless-ngx:v3.1.3
    container_name: paperless-ngx
    ports:
      - '8000:8000'
    volumes:
      - /opt/paperless-ngx/data:/data
      - /opt/paperless-ngx/config:/config
    environment:
      PAPERLESS_DB_URL: 'sqlite:///data/paperless.db'
      PAPERLESS_MEDIA_ROOT: '/data/media'
      PAPERLESS_LOG_LEVEL: 'INFO'
    restart: unless-stopped

Проверка запуска

После запуска контейнера проверьте, что Paperless-ngx доступен по адресу http://localhost:8000. Если возникают ошибки, убедитесь, что порт 8000 не занят и Docker работает корректно.

Обновление системы

Для обновления Paperless-ngx выполните следующие шаги:

1. Остановите контейнер с помощью команды docker-compose down.
2. Удалите старую версию образа с помощью docker rmi ghcr.io/paperless-ngx/paperless-ngx:v3.1.3.
3. Обновите файл compose.yaml до новой версии.
4. Запустите контейнер с помощью docker-compose up -d.

Резервное копирование данных

Для резервного копирования данных используйте следующие команды:

1. Создайте резервную копию папки /opt/paperless-ngx/data с помощью rsync -av /opt/paperless-ngx/data /backup/paperless-ngx-data.
2. Создайте резервную копию базы данных с помощью sqlite3 data/paperless.db .dump > backup.sql.
3. Регулярно проверяйте резервные копии и храните их в безопасном месте.