Paperless-AI installieren (Linux) – One-Liner Installer-Skript mit Docker & Caddy HTTPS

Paperless-KI selbst installieren oder als betreute Lösung einsetzen?

WZ-IT übernimmt Installation, Absicherung und Betrieb von Paperless-AI auf vorhandener Infrastruktur. Für sensible Dokumente kann der AI Cube die vollständig vorkonfigurierte lokale Modellplattform im eigenen Netzwerk bereitstellen.

Paperless-KI umsetzen lassen · AI Cube ansehen · Erstgespräch vereinbaren

Hinweis (Stand Oktober 2026): Paperless-AI wird seit dem 31.03.2026 nicht mehr gepflegt (Hinweis im README), das letzte Release ist v3.0.9 vom 04.11.2025. Paperless-ngx bringt seit Version 3.0.0 vom 22.07.2026 eigene KI-Funktionen mit. Für neue und produktive Installationen empfehlen wir diesen Weg: Paperless-ngx KI einrichten. Diese Anleitung bleibt für Tests und bestehende Paperless-AI-Setups online.

Paperless-AI ist eine KI-Erweiterung für Paperless-ngx, die eingehende Dokumente automatisch analysiert und mit passenden Tags versieht. Egal ob OpenAI, lokale Modelle mit Ollama oder Azure - Paperless-AI nutzt LLMs um Dokumentinhalte zu verstehen.

Wir haben ein kostenloses Open-Source Installer-Skript gebaut, das Paperless-AI mit Docker in wenigen Minuten deployt. Das Skript fragt nur Installationsverzeichnis und optional eine Domain ab; Paperless-ngx-Verbindung und KI-Provider werden danach in der Weboberfläche von Paperless-AI eingerichtet.

Inhaltsverzeichnis

• Was dabei ist
• Voraussetzungen
• Option 1: Quick Install (Ein Befehl)
• Option 2: Erst prüfen, dann installieren (Empfohlen)
• So läuft die Installation
• Nach der Installation
• Nützliche Befehle
• Deinstallation
• Troubleshooting
• Quellcode

Was dabei ist

Unser Installer-Skript bietet:

• Automatische Docker-Installation - Docker und Docker Compose werden bei Bedarf installiert
• Kurze interaktive Abfrage - Installationsverzeichnis und optionale Domain
• Optionales HTTPS - Caddy Reverse Proxy mit automatischen Let's Encrypt Zertifikaten
• Web-Interface - Konfiguration direkt im Browser nach Installation
• Testumgebung in Minuten - Sinnvolle Defaults für Evaluierung und Tests

Voraussetzungen

• Linux-Server (Ubuntu, Debian, CentOS, RHEL, etc.)
• bash und curl (auf den meisten Systemen vorinstalliert)
• sudo-Rechte für Docker-Installation
• Laufende Paperless-ngx Instanz mit API-Zugang
• Für HTTPS: Domain mit DNS auf den Server

Option 1: Quick Install (Ein Befehl)

Wenn ihr der Quelle vertraut, reicht ein Befehl:

curl -fsSL https://raw.githubusercontent.com/wzitcom/public-scripts/main/open-source-apps/paperless-ai/install.sh | bash

Option 2: Erst prüfen, dann installieren (Empfohlen)

Wer auf Nummer sicher gehen will, lädt das Skript erst runter und schaut rein:

# Installer herunterladen
curl -O https://raw.githubusercontent.com/wzitcom/public-scripts/main/open-source-apps/paperless-ai/install.sh

# Skript durchschauen
cat install.sh

# Ausführbar machen und starten
chmod +x install.sh
./install.sh

Generell empfehlen wir, Skripte vor der Ausführung zu prüfen - besonders wenn sie mit sudo laufen.

So läuft die Installation

Beim Ausführen des Installers erscheint ein interaktiver Setup:

Das Skript fragt nach:

1. Installationsverzeichnis - Wo die Config-Dateien liegen (Default: ~/paperless-ai)
2. Domain - Optional für HTTPS-Setup

Danach passiert automatisch:

• Docker wird bei Bedarf installiert
• docker-compose.yml wird mit den Einstellungen erstellt
• Caddy wird für HTTPS eingerichtet (falls Domain angegeben)
• Container wird gestartet
• URL und nächste Schritte werden angezeigt (das Skript erzeugt keine Zugangsdaten)

Nach der Installation

Nach Abschluss läuft der Container und die Ersteinrichtung erfolgt im Browser:

Erster Login

1. Web-Interface öffnen (http://localhost:3000 oder eure Domain)
2. Paperless-ngx Verbindung konfigurieren:
   • Paperless-ngx URL
   • API Token
3. AI Provider einrichten:
   • OpenAI API Key, oder
   • Ollama Verbindung, oder
   • Andere unterstützte Provider

Funktionsweise

1. Paperless-AI verbindet sich mit eurer Paperless-ngx Instanz
2. Neue Dokumente werden automatisch erkannt
3. Die KI analysiert den Dokumentinhalt
4. Passende Tags werden automatisch zugewiesen

Installationsdateien

Im Installationsverzeichnis liegen:

Nützliche Befehle

Erst ins Installationsverzeichnis wechseln:

cd ~/paperless-ai

Service-Verwaltung

# Logs anzeigen
docker compose logs -f
docker compose logs -f paperless-ai
docker compose logs -f caddy  # Bei Caddy

# Services stoppen
docker compose down

# Services starten
docker compose up -d

# Services neustarten
docker compose restart

# Status checken
docker compose ps

Updates

# Neueste Images ziehen und neustarten
docker compose pull
docker compose up -d

Deinstallation

Paperless-AI komplett entfernen:

cd ~/paperless-ai

# Container stoppen und entfernen
docker compose down

# Auch Volumes entfernen (ACHTUNG: löscht alle Daten!)
docker compose down -v

# Installationsverzeichnis löschen
cd ~
rm -rf ~/paperless-ai

Troubleshooting

Port schon belegt

Wenn Port 3000 (oder 80/443 bei Caddy) belegt ist:

# Schauen was die Ports nutzt
sudo lsof -i :3000
sudo lsof -i :80
sudo lsof -i :443

SSL-Zertifikat-Probleme

# Caddy-Logs checken
docker compose logs caddy

# DNS prüfen
nslookup eure-domain.com

Verbindung zu Paperless-ngx schlägt fehl

• Sicherstellen dass Paperless-ngx von diesem Server erreichbar ist
• Firewall-Regeln zwischen den Servern prüfen
• API-Token auf Korrektheit prüfen

Container startet nicht

# Container-Logs checken
docker compose logs paperless-ai

# Container-Status anzeigen
docker ps -a

Quellcode

Das Installer-Skript ist Open Source auf GitHub:

• Repository: github.com/wzitcom/public-scripts
• Paperless-AI Installer: open-source-apps/paperless-ai

Gerne reinschauen, forken oder beitragen!

Hinweis

Das Skript ist für schnelles Deployment von Dev- und Test-Umgebungen gedacht. Da Paperless-AI seit dem 31.03.2026 nicht mehr gepflegt wird, empfehlen wir für Produktion die native KI von Paperless-ngx.

Für jeden produktiven Betrieb solltet ihr beachten:

• Security Hardening
• Sichere Speicherung von API-Keys
• Firewall- und Netzwerk-Regeln
• Backup-Strategie
• Monitoring und Alerting
• Angepasste Konfiguration

Produktionsreifes Setup gesucht? Kontaktiert WZ-IT für professionelle Paperless-ngx-Installation mit KI-Anbindung und Managed Hosting.