Jak zainstalować Paperless-ngx z Nginx na Debian

Paperless-ngx to nowoczesny system do zarządzania dokumentami (DMS), który automatycznie indeksuje, taguje i przechowuje pliki PDF oraz skany. Idealny dla firm, biur rachunkowych i środowisk IT.

1. Wymagania

• Debian 11 / 12
• Minimum 2 GB RAM
• Root access

2. Aktualizacja systemu

apt update && apt upgrade -y

3. Instalacja Docker i Docker Compose

apt install docker.io docker-compose -y
systemctl enable docker
systemctl start docker

4. Pobranie Paperless-ngx

mkdir -p /opt/paperless
cd /opt/paperless
wget https://github.com/paperless-ngx/paperless-ngx/releases/latest/download/docker-compose.yml

5. Konfiguracja środowiska

nano docker-compose.env

PAPERLESS_SECRET_KEY=losowy_klucz
PAPERLESS_TIME_ZONE=Europe/Warsaw
PAPERLESS_OCR_LANGUAGE=pol

6. Uruchomienie kontenerów

docker-compose up -d

7. Instalacja Nginx (reverse proxy)

apt install nginx -y

nano /etc/nginx/sites-available/paperless

server {
  listen 80;
  server_name twojadomena.pl;

  location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
  }
}

ln -s /etc/nginx/sites-available/paperless /etc/nginx/sites-enabled/
systemctl restart nginx

8. Dostęp do aplikacji

Wejdź w przeglądarce:

http://twojadomena.pl

9. HTTPS (zalecane)

apt install certbot python3-certbot-nginx -y
certbot --nginx -d twojadomena.pl

10. Backup

• Katalog /opt/paperless/data
• Baza danych

11. Najczęstsze błędy

• Port 8000 zajęty
• Błędy w docker-compose.env
• Brak RAM (OCR wymaga zasobów)

12. Wydajność

• NVMe SSD
• 4+ GB RAM dla OCR
• CPU z wieloma rdzeniami

Podsumowanie

Paperless-ngx to jedno z najlepszych rozwiązań do zarządzania dokumentami. W połączeniu z VPS daje pełną kontrolę nad danymi i bezpieczeństwem.