Self-Hosting con Paperclip: Gestione Documentale sul Proprio VPS

Chi lavora con documenti sensibili — contratti, fatture, cartelle cliniche, materiali di ricerca — sa che affidarli a un SaaS cloud è un atto di fiducia che forse si preferirebbe evitare. Paperclip è un sistema di gestione documentale self-hosted che ti dà il controllo totale su ogni byte della tua libreria documentale.

Questo articolo spiega cosa fa bene Paperclip, a chi si rivolge, come distribuirlo su un VPS e come integrarlo in un workflow self-hosted più ampio.

Cosa distingue Paperclip

La maggior parte dei file manager self-hosted (Nextcloud, Seafile) sono soluzioni di cloud storage generiche. Paperclip è progettato specificamente per la gestione documentale: l’ingestione, l’OCR, i metadati e il recupero sono al centro del suo funzionamento, non la sincronizzazione o la condivisione di file.

Differenze chiave:

OCR all’ingestione: ogni PDF o immagine caricata viene elaborata automaticamente dall’OCR e diventa ricercabile.
Design metadati-first: titolo, data, mittente, tipo di documento, tag — tutti campi strutturati, non solo nomi di file.
Import di massa: deposita centinaia di file in una cartella monitorata, Paperclip li elabora automaticamente.
Regole di retention: imposta politiche di eliminazione o archiviazione automatica per tipo di documento.

A chi si rivolge Paperclip

Freelance e liberi professionisti: organizza fatture, contratti e documenti fiscali con OCR automatico e tag.
Piccoli team: repository documentale condiviso con controlli di accesso e ricerca full-text.
Appassionati di homelab: sostituisci una gerarchia di cartelle su NAS/VPS con un database documentale ricercabile e taggato.
Utenti attenti alla privacy: nessun provider cloud ha accesso ai tuoi documenti.

Requisiti VPS

Spec	Minimo	Consigliato
vCPU	1	2
RAM	1 GB	2–4 GB
Storage	20 GB	50 GB+
OS	Ubuntu 22.04 / Debian 12	Ubuntu 22.04 LTS
Database	SQLite	PostgreSQL (multi-utente)

Provider consigliati:

Hetzner Cloud — 4,15 €/mese, 2 vCPU, 4 GB di RAM — miglior scelta complessiva per utenti EU
Contabo VPS — 5,99 €/mese, 4 vCPU, 8 GB di RAM, 200 GB storage — migliore per archivi grandi

Guida di configurazione completa

1. Installare Docker

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

2. Distribuire Paperclip con Docker Compose

Crea /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/documenti:/watch  # cartella monitorata opzionale
    environment:
      - PAPERCLIP_SECRET_KEY=la_tua_chiave_casuale_qui
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=ita  # per documenti in italiano

volumes:
  paperclip_data:

Avviare lo stack:

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

3. Esporre tramite HTTPS

Con Caddy per TLS automatico:

apt install caddy -y

/etc/caddy/Caddyfile:

docs.tuodominio.it {
    reverse_proxy localhost:8080
}

systemctl reload caddy

4. Configurare i tipi di documento

Nell’interfaccia web di Paperclip, definisci tipi di documento (es.: “Fattura”, “Contratto”, “Ricevuta”) e assegna regole di archiviazione. Il recupero sarà molto più rapido rispetto al basarsi solo sui nomi dei file.

5. Configurare una cartella monitorata

Monta una cartella locale del tuo VPS sul volume /watch. Qualsiasi file depositato viene automaticamente ingerito, elaborato dall’OCR e aggiunto alla libreria — ideale per import di massa o workflow automatizzati.

Integrazioni ed estensioni

Workflow senza carta: combina Paperclip con un’app di scansione (Scanbot, Adobe Scan) che invii direttamente alla casella di posta di Paperclip via email o upload — pipeline completamente automatizzata dalla carta al digitale ricercabile.

Backup su S3: usa rclone per sincronizzare il volume dati di Paperclip con Backblaze B2 o qualsiasi bucket compatibile S3:

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

Nginx Proxy Manager: se usi già NPM sul tuo VPS, punta semplicemente un proxy host su paperclip:8080 e abilita Let’s Encrypt dalla GUI.

Authentik / Authelia: aggiungi SSO davanti a Paperclip con un identity provider per installazioni multi-utente.

Consigli di manutenzione

Aggiornamenti regolari: docker compose pull && docker compose up -d
Monitorare lo spazio su disco: l’output OCR e le miniature crescono nel tempo — imposta alert con df -h
Eseguire backup del volume dati prima di qualsiasi aggiornamento
Tuning di PostgreSQL: per librerie grandi, aumenta work_mem e max_connections in postgresql.conf

Riepilogo

Paperclip è uno dei gestori documentali self-hosted meglio mantenuti disponibili. Per un deploy su VPS, Hetzner Cloud copre la maggior parte degli utenti a 4,15 €/mese. Se hai bisogno di storage serio per un grande archivio documentale, Contabo offre 200 GB NVMe a 5,99 €/mese.

Vedi anche: Confronto VPS completo su selfhostvps.com