Self-Hosting mit Paperclip: Dokumentenverwaltung auf dem eigenen VPS

Wer mit sensiblen Dokumenten arbeitet — Verträgen, Rechnungen, medizinischen Unterlagen, Forschungsmaterialien — muss beim Einsatz eines Cloud-SaaS darauf vertrauen, dass der Anbieter sorgsam damit umgeht. Paperclip ist ein selbst gehostetes Dokumentenverwaltungssystem, das vollständige Kontrolle über jedes Byte der eigenen Dokumentenbibliothek bietet.

Dieser Artikel erklärt, was Paperclip auszeichnet, für wen es geeignet ist, wie es auf einem VPS eingerichtet wird und wie es in einen breiteren Self-Hosting-Workflow integriert werden kann.

Was Paperclip besonders macht

Die meisten selbst gehosteten Dateimanager (Nextcloud, Seafile) sind Allzweck-Cloudspeicherlösungen. Paperclip ist speziell für Dokumentenverwaltung konzipiert: Im Mittelpunkt stehen Erfassung, OCR, Metadaten und Abruf — nicht Synchronisation oder Dateifreigabe.

Wesentliche Unterschiede:

OCR bei der Einspeisung: Jede hochgeladene PDF oder jedes Bild wird automatisch per OCR verarbeitet und damit durchsuchbar.
Metadaten-First-Design: Titel, Datum, Korrespondent, Dokumenttyp, Tags — alles strukturierte Felder, nicht nur Dateinamen.
Massenimport: Hunderte Dateien in einen Überwachungsordner ablegen, Paperclip verarbeitet sie automatisch.
Aufbewahrungsregeln: Automatische Lösch- oder Archivierungsrichtlinien pro Dokumenttyp festlegen.

Für wen ist Paperclip geeignet?

Freelancer und Auftragnehmer: Rechnungen, Verträge und Steuerdokumente mit automatischer OCR und Tagging organisieren.
Kleine Teams: Gemeinsames Dokumentenarchiv mit Zugriffskontrollen und Volltextsuche.
Homelab-Enthusiasten: Ordnerhierarchien auf NAS/VPS durch eine durchsuchbare, getaggte Dokumentendatenbank ersetzen.
Datenschutzbewusste Nutzer: Kein Cloud-Anbieter hat Zugriff auf die eigenen Dokumente.

VPS-Anforderungen

Spec	Minimum	Empfohlen
vCPU	1	2
RAM	1 GB	2–4 GB
Speicher	20 GB	50 GB+
OS	Ubuntu 22.04 / Debian 12	Ubuntu 22.04 LTS
Datenbank	SQLite	PostgreSQL (Mehrbenutzer)

Empfohlene Anbieter:

Hetzner Cloud — 4,15 €/Monat, 2 vCPU, 4 GB RAM — beste Gesamtwahl für EU-Nutzer
Contabo VPS — 5,99 €/Monat, 4 vCPU, 8 GB RAM, 200 GB Speicher — beste Option für große Archive

Vollständige Einrichtungsanleitung

1. Docker installieren

curl -fsSL https://get.docker.com | sh
systemctl enable --now docker

2. Paperclip mit Docker Compose deployen

/opt/paperclip/docker-compose.yml erstellen:

version: "3.8"

services:
  paperclip:
    image: paperclip/paperclip:latest
    container_name: paperclip
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - paperclip_data:/data
      - /mnt/dokumente:/watch  # optionaler Überwachungsordner
    environment:
      - PAPERCLIP_SECRET_KEY=zufaelliger_schluessel_hier
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=deu  # für deutsche Dokumente

volumes:
  paperclip_data:

Stack starten:

cd /opt/paperclip && docker compose up -d

3. HTTPS einrichten

Mit Caddy für automatisches TLS:

apt install caddy -y

/etc/caddy/Caddyfile:

docs.ihredomain.de {
    reverse_proxy localhost:8080
}

systemctl reload caddy

4. Dokumenttypen konfigurieren

In der Paperclip-Web-Oberfläche Dokumenttypen definieren (z. B. „Rechnung”, „Vertrag”, „Quittung”) und Speicherregeln zuweisen. Das beschleunigt den Abruf erheblich gegenüber der reinen Dateinamen-Suche.

5. Überwachungsordner einrichten

Einen lokalen Ordner auf dem VPS dem /watch-Volume-Mount zuordnen. Jede dort abgelegte Datei wird automatisch eingespeist, per OCR verarbeitet und der Bibliothek hinzugefügt — ideal für Massenimporte oder automatisierte Workflows.

Integrationen und Erweiterungen

Papierloses Büro: Paperclip mit einer Scanner-App (Scanbot, Adobe Scan) kombinieren, die direkt in die Paperclip-Inbox per E-Mail oder Upload liefert — vollautomatische Papier-zu-digital-Pipeline.

Backup auf S3: Mit rclone das Paperclip-Datenvolume auf Backblaze B2 oder einen S3-kompatiblen Bucket spiegeln:

rclone sync /var/lib/docker/volumes/paperclip_data/_data remote:paperclip-backup

Nginx Proxy Manager: Falls NPM bereits auf dem VPS läuft, einfach einen Proxy-Host auf paperclip:8080 zeigen und Let’s Encrypt über die GUI aktivieren.

Authentik / Authelia: SSO vor Paperclip schalten mit einem Identity Provider für Mehrbenutzer-Installationen.

Wartungstipps

Regelmäßige Updates: docker compose pull && docker compose up -d
Speicherverbrauch überwachen: OCR-Ausgabe und Vorschaubilder wachsen mit der Zeit — df -h-Alerts einrichten
Datenvolume vor jedem Update sichern
PostgreSQL-Tuning: Bei großen Bibliotheken work_mem und max_connections in postgresql.conf erhöhen

Fazit

Paperclip ist eine der am besten gepflegten selbst gehosteten Dokumentenverwaltungslösungen. Für einen VPS-Betrieb deckt Hetzner Cloud die meisten Anwendungsfälle bei 4,15 €/Monat ab. Wer ernsthaften Speicherbedarf für ein großes Dokumentenarchiv hat, bekommt bei Contabo 200 GB NVMe für 5,99 €/Monat.

Siehe auch: Vollständiger VPS-Vergleich auf selfhostvps.com