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

Professionelles Paperless-ngx Hosting oder Installation gesucht? Wir bei WZ-IT übernehmen Beratung, Installation, Support, Betrieb, Wartung und Monitoring von Paperless-ngx und Paperless-AI - auf unserer Infrastruktur oder eurer. Kostenlose Beratung vereinbaren: Termin buchen.

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 - mit interaktiver Konfiguration für alle unterstützten AI-Provider.

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
• Interaktive Konfiguration - Installationsverzeichnis, Domain und Paperless-ngx Verbindung wählen
• Optionales HTTPS - Caddy Reverse Proxy mit automatischen Let's Encrypt Zertifikaten
• Web-Interface - Konfiguration direkt im Browser nach Installation
• Produktionsreifes Setup - Sinnvolle Defaults für sofortigen Einsatz

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
• Zugangsdaten werden angezeigt

Nach der Installation

Nach Abschluss ist Paperless-AI einsatzbereit:

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.

Für Produktion 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 und Paperless-AI Installation und Managed Hosting.