Arama Yap Mesaj Senden
Rückruf anfordern
+90
X
X

Wählen Sie Ihre Währung

Türkische Lira $ US Dollar Euro
X
X

Wählen Sie Ihre Währung

Türkische Lira $ US Dollar Euro

Kontaktieren Sie uns

Standort Halkali Merkez Viertel Fatih Str. Ozgur Apt. No. 46, Kucukcekmece, Istanbul, 34303, TR

Paperless-ngx installieren: Dokumenten- und Rechnungsarchiv mit OCR

Paperless-ngx mit PostgreSQL, Redis und OCR auf Ubuntu: Scanner-Import, E-Mail, Regeln, Nginx-TLS, Export-Backup, Restore und Integritätsprüfung.

Paperless-ngx installieren: Dokumenten- und Rechnungsarchiv mit OCR
Was läuft am Ende dieser Anleitung?

Paperless-ngx mit PostgreSQL, Redis und OCR auf Ubuntu: Scanner-Import, E-Mail, Regeln, Nginx-TLS, Export-Backup, Restore und Integritätsprüfung. Beispiel-Domains, Passwörter und Secrets müssen vor der Ausführung durch eigene Werte ersetzt werden.

Architektur und Anforderungen vor der Installation

  • Ubuntu 24.04 LTS mit sudo-Zugriff und eigener IPv4-Adresse
  • Docker Engine und Compose v2 für containerbasierte Bereitstellungen
  • DNS-A-Record vom Anwendungsnamen auf den Server
  • NVMe-Kapazität für Daten, Logs, temporäre Dateien und Backups
  • CPU- und RAM-Reserve anhand gemessener Gleichzeitigkeit

DNS- und Portplan

  • 80/443 TCP: HTTPS
  • 8000/TCP: yalnız reverse proxy
  • 5432/6379: yalnız Docker ağı

Praktische Installationsschritte

1. Kurulum dosyaları
mkdir -p /opt/paperless-ngx
cd /opt/paperless-ngx
curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.postgres.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.env -o docker-compose.env
2. Temel ayarlar
PAPERLESS_URL=https://documents.example.com
PAPERLESS_TIME_ZONE=Europe/Istanbul
PAPERLESS_OCR_LANGUAGE=tur+eng+deu
PAPERLESS_OCR_LANGUAGES=tur deu
PAPERLESS_SECRET_KEY=GUCLU_RASTGELE_SECRET
PAPERLESS_ADMIN_USER=ekaadmin
PAPERLESS_ADMIN_PASSWORD=ILK_GIRISTEN_SONRA_DEGISTIR
PAPERLESS_REDIS=redis://broker:6379
PAPERLESS_DBHOST=db
3. Dizinler
mkdir -p consume export data media
sudo chown -R 1000:1000 consume export data media
sudo docker compose --env-file docker-compose.env config
sudo docker compose --env-file docker-compose.env up -d
4. Sağlık ve OCR
sudo docker compose ps
sudo docker compose logs --tail 150 webserver
sudo docker compose exec webserver tesseract --list-langs
curl -I http://127.0.0.1:8000
5. Tam exporter yedeği
sudo docker compose exec -T webserver document_exporter ../export --compare-checksums --delete --no-progress-bar
find export -type f | wc -l
sha256sum export/manifest.json
6. Geri yükleme
sudo docker compose down
sudo docker compose up -d db broker
sudo docker compose run --rm webserver document_importer ../export --no-progress-bar
sudo docker compose up -d
7. Bütünlük denetimi
sudo docker compose exec webserver document_sanity_checker
sudo docker compose exec webserver document_index reindex --if-needed
sudo docker compose exec webserver document_create_classifier
8. Nginx reverse proxy
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
sudo tee /etc/nginx/sites-available/documents.example.com > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name documents.example.com;
    client_max_body_size 10G;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
NGINX
sudo ln -s /etc/nginx/sites-available/documents.example.com /etc/nginx/sites-enabled/documents.example.com
sudo nginx -t
sudo systemctl reload nginx
9. Let’s Encrypt SSL ve yenileme testi
sudo certbot --nginx -d documents.example.com --redirect --agree-tos --no-eff-email -m [email protected]
sudo certbot renew --dry-run
curl -I https://documents.example.com
openssl s_client -connect documents.example.com:443 -servername documents.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

Wichtige Punkte vor dem Produktivbetrieb

Produktionshinweis
Paperless-ngx installieren muss hinter HTTPS isoliert werden; Datenbank, Queue und interne APIs dürfen nicht direkt im Internet veröffentlicht werden.
Produktionshinweis
Vor Produktion getestete Image-Versionen fixieren. Vor Migrationen Release Notes lesen und ein konsistentes Backup erstellen.
Produktionshinweis
Ein Datenbank-Dump allein kann unvollständig sein. Persistente Dateien, Konfiguration, Schlüssel und exakte Version gemeinsam sichern.
Produktionshinweis
Eine echte Transaktion testen, den Host neu starten und die automatische Wiederherstellung prüfen, bevor produktiver Traffic zugelassen wird.

Häufige Fehler und Ursachen

Belirti / SymptomKök neden ve çözüm / Root cause and fix
Dienst oder Container startet nichtCompose-Konfiguration, Abhängigkeiten, Dateirechte und die erste fatale Logzeile prüfen statt wiederholt neu zu starten.
Domain erreichbar, HTTPS fehlerhaftA/AAAA, Ports 80/443, Proxy-Modus, Zertifikatsprüfung und konkurrierende Reverse Proxies prüfen.
Datenbank oder Queue nicht erreichbarInternen Servicenamen und Credentials prüfen; Datenbankports nicht öffentlich freigeben.
Unter Last instabilRAM-Spitzen, Disk-Latenz, Connection Pools und Worker-Concurrency messen und den Engpass gezielt beheben.

Validierung nach der Installation

  • Alle Dienste laufen und Healthchecks sind erfolgreich
  • Hostname liefert ein gültiges HTTPS-Zertifikat
  • Nur erforderliche Ports sind erreichbar
  • MFA und Notfallzugriff für Administratoren sind eingerichtet
  • Backup-Prüfsummen wurden gespeichert
  • Restore in isolierter Umgebung wurde getestet
  • Keine wiederkehrenden kritischen Fehler in Logs
  • Dienste starten nach einem Host-Neustart automatisch

Offizielle technische Quellen

Passende EKA-Sunucu-Anleitungen

Häufig gestellte Fragen

Ist die Installation produktionsgeeignet?

Ja, nachdem Secrets ersetzt, Zugriffe begrenzt und ein vollständiger Restore erfolgreich getestet wurde.

Reichen Mindestressourcen?

Mindestwerte zeigen nur, dass Software startet. CPU, RAM, IOPS und Speicher anhand echter Last dimensionieren.

Kann Cloudflare verwendet werden?

Ja. Full (strict) TLS sowie Origin-Zertifikat, WebSockets und echte Client-IP korrekt konfigurieren.

Updates automatisch installieren?

Major Releases nicht automatisch installieren. Migrationen prüfen, Backup erstellen und altes Image bereithalten.

Was muss gesichert werden?

Datenbank, Uploads, Volumes, Konfiguration, Schlüssel und genaue Version gemeinsam sichern.

VPS oder GPU-Server?

NVMe-VPS passt für Web-Workloads; Inferenz, OCR-Beschleunigung und Transcoding können eine GPU benötigen.

Kontakt für die Bereitstellung

Paperless-ngx mit PostgreSQL, Redis und OCR auf Ubuntu: Scanner-Import, E-Mail, Regeln, Nginx-TLS, Export-Backup, Restore und Integritätsprüfung.

VPS-Angebote ansehenKontakt für die Bereitstellung
Top