Self-Hosting met Paperclip: Documentbeheer op je Eigen VPS

Voor iedereen die gevoelige documenten behandelt - contracten, facturen, medische dossiers, onderzoeksmateriaal - ze toevertrouwen aan een cloud SaaS is een vertrouwensproces dat je misschien niet wilt aangaan. Paperclip is een zelfgehost documentbeheersysteem waarmee je elke byte van je documentbibliotheek in eigen hand hebt.

Dit artikel behandelt wat Paperclip goed doet, voor wie het bedoeld is, hoe je het op een VPS inzet, en hoe je het integreert in een breder zelfgehost workflow.

Wat Maakt Paperclip Anders

De meeste zelfgehoste bestandsmanagers (Nextcloud, Seafile) zijn algemene cloudopslag-systemen. Paperclip is specifiek ontwikkeld voor documentbeheer: het richt zich op inname, OCR, metadata en zoekfunctie in plaats van synchronisatie of bestandsdeling.

Belangrijke onderscheidingen:

OCR bij inname: Elke PDF of afbeelding die je uploadt wordt automatisch OCR-gedaan, waardoor gescande documenten doorzoekbaar worden.
Metadata-eerst ontwerp: Titel, datum, afzender, documenttype, tags - allemaal gestructureerde velden, niet alleen bestandsnamen.
Bulk import: Drop honderden bestanden in een watch-folder en Paperclip verwerkt ze automatisch.
Retention-regels: Stel automatische verwijderings- of archiefbeleid in per documenttype.

Voor Wie Is Paperclip Geschikt

Freelancers en contractors: Organiseer facturen, contracten en belastingdocumenten met automatische OCR en tagging.
Kleine teams: Gedeeld documentarchief met toegangscontrole en volledige tekst zoekfunctie.
Homelabbers: Vervang een mapstructuur op NAS/VPS met een doorzoekbare, getagde documentendatabase.
Privacybewuste gebruikers: Geen cloudleverancier heeft toegang tot jouw documenten.

VPS-vereisten

Paperclip is lichtgewicht genoeg voor een instap-VPS:

Specificatie	Minimaal	Aanbevolen
vCPU	1	2
RAM	1GB	2-4GB
Opslag	20GB	50GB+
OS	Ubuntu 22.04 / Debian 12	Ubuntu 22.04 LTS
Database	SQLite	PostgreSQL (multi-user)

Aanbevolen providers:

Hetzner Cloud - €4,15/maand, 2 vCPU, 4GB RAM - het beste voor EU-gebruikers
Contabo VPS - €5,99/maand, 4 vCPU, 8GB RAM, 200GB opslag - het beste bij grote archieven

Complete Setup Gids

1. Installeer Docker

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

2. Implementeer Paperclip met Docker Compose

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

version: "3.8"

services:
  paperclip:
    image: paperclip/paperclip:latest
    container_name: paperclip
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - paperclip_data:/data
      - /mnt/documents:/watch  # optionele watch-folder
    environment:
      - PAPERCLIP_SECRET_KEY=je_willekeurige_geheime_waarde_hier
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=eng  # wijzig voor andere talen

volumes:
  paperclip_data:

Start de stack:

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

3. Openen via HTTPS

Gebruik Caddy voor automatische TLS:

apt install caddy -y

/etc/caddy/Caddyfile:

docs.jouwdomijn.com {
    reverse_proxy localhost:8080
}

systemctl reload caddy

4. Configureer Documenttypes

In de Paperclip web UI, definieer documenttypes (bijvoorbeeld “Factuur”, “Contract”, “Bonnetje”) en wijs opslagregels toe. Dit maakt zoeken veel sneller dan alleen op bestandsnaam.

5. Stel een Watch Folder in

Punt een lokale map op je VPS aan naar de /watch volume-montage. Bestanden die daar worden toegevoegd, worden automatisch ingelezen, OCR-bewerkt en aan de bibliotheek toegevoegd - handig voor bulk-importen of geautomatiseerde workflows.

Integraties en Extensies

Workflow zoals Paperless: Combineer Paperclip met een scannerapp (Scanbot, Adobe Scan) die per e-mail of direct uploadt naar je Paperclip inbox voor een volledig geautomatiseerde papieren-naar-zoekbare digitale workflow.

Backup naar S3: Gebruik rclone om je Paperclip data volume te spiegelen naar Backblaze B2 of elke S3-compatibele bucket:

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

Nginx Proxy Manager: Als je al een NPM-instantie draait op je VPS, wijs een proxyhost toe aan paperclip:8080 en activeer Let’s Encrypt vanuit de GUI.

Authentik / Authelia: Voeg SSO toe voor Paperclip via een identiteitsprovider voor multi-user installaties.

Onderhoudstips

Regelmatig bijwerken: docker compose pull && docker compose up -d
Controleer schijfgebruik: OCR-uitvoer en thumbnails groeien in de tijd - stel alerts in met df -h
Maak back-ups van de datavolume vóór een upgrade
PostgreSQL afstemming: Voor grote bibliotheken, verhoog work_mem en max_connections in postgresql.conf

Samenvatting

Paperclip is een van de best onderhouden zelfgehoste documentmanagers die beschikbaar zijn. Voor een VPS-deploymentsituatie dekt Hetzner Cloud voor de meeste gebruikers €4,15/maand. Als je serieuze opslag nodig hebt voor een grote documentarchief, levert Contabo 200GB NVMe voor €5,99/maand.

De combinatie van Docker-simpelheid, OCR-standaard en metadata-eerst organisatie maken van Paperclip een aantrekkelijk alternatief voor cloud documentdiensten.

Zie ook: Volledige VPS-vergelijking op selfhostvps.com