Self-Hosting dengan Paperclip: Manajemen Dokumen di VPS Anda Sendiri

Self-Hosting dengan Paperclip: Manajemen Dokumen di VPS Anda Sendiri

Bagi siapa saja yang menangani dokumen sensitif - kontrak, faktur, rekam medis, materi penelitian - menyerahkannya ke layanan cloud SaaS mungkin bukan pilihan yang nyaman karena kepercayaan. Paperclip adalah sistem manajemen dokumen yang di-self-host dan memungkinkan Anda memiliki kendali penuh atas seluruh perpustakaan dokumen Anda.

Artikel ini membahas apa yang dilakukan Paperclip dengan baik, siapa yang cocok menggunakannya, cara meng-deploy-nya di VPS, dan bagaimana mengintegrasikannya ke dalam workflow self-hosted yang lebih luas.

Apa yang Membuat Paperclip Berbeda

Sebagian besar pengelola file self-hosted (Nextcloud, Seafile) adalah sistem penyimpanan cloud yang bersifat umum. Paperclip dirancang khusus untuk manajemen dokumen: fokus pada ingestion, OCR, metadata, dan pencarian, bukan sinkronisasi atau berbagi file.

Faktor pembeda utama:

• OCR saat ingestion: Setiap PDF atau gambar yang diupload otomatis akan diproses OCR-nya, sehingga dokumen yang dipindai menjadi bisa dicari.
• Desain berbasis metadata: Judul, tanggal, pengirim, tipe dokumen, tag - semua merupakan field terstruktur, bukan hanya nama file.
• Impor massal: Taruh ratusan file ke dalam folder pengawasan dan Paperclip akan memprosesnya secara otomatis.
• Aturan retensi: Tetapkan kebijakan penghapusan otomatis atau pengarsipan berdasarkan tipe dokumen.

Siapa yang Harus Menggunakan Paperclip

• Freelancer dan contractor: Mengelola faktur, kontrak, dan dokumen pajak dengan OCR otomatis dan tagging.
• Tim kecil: Repositori dokumen bersama dengan kontrol akses dan pencarian teks lengkap.
• Homelabbers: Gantikan struktur folder di NAS/VPS dengan basis data dokumen yang dapat dicari dan memiliki tag.
• Pengguna yang peduli privasi: Tidak ada vendor cloud yang memiliki akses ke dokumen Anda.

Persyaratan VPS

Paperclip cukup ringan untuk dijalankan pada VPS tingkat awal:

Penyedia yang Disarankan:

• Hetzner Cloud - €4.15/bulan, 2 vCPU, 4GB RAM - cocok untuk pengguna di Eropa
• Contabo VPS - €5.99/bulan, 4 vCPU, 8GB RAM, 200GB penyimpanan - cocok jika Anda memiliki arsip besar

Panduan Pengaturan Lengkap

1. Install Docker

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

2. Deploy Paperclip dengan Docker Compose

Buat file /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  # folder pengawasan opsional
    environment:
      - PAPERCLIP_SECRET_KEY=your_random_secret_here
      - PAPERCLIP_OCR_ENABLED=true
      - PAPERCLIP_OCR_LANGUAGE=eng  # ubah sesuai bahasa lain

volumes:
  paperclip_data:

Lanjutkan dengan menjalankan:

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

3. Ekspos melalui HTTPS

Menggunakan Caddy untuk TLS otomatis:

apt install caddy -y

File /etc/caddy/Caddyfile:

docs.yourdomain.com {
    reverse_proxy localhost:8080
}

Lalu reload Caddy:

systemctl reload caddy

4. Konfigurasi Tipe Dokumen

Di antarmuka web Paperclip, tentukan tipe dokumen (misalnya, “Invoice”, “Contract”, “Receipt”) dan tetapkan aturan penyimpanan. Ini mempercepat pencarian dibanding hanya mengandalkan nama file.

5. Siapkan Folder Pengawasan

Arahkan folder lokal di VPS ke volume /watch. File yang disimpan di sana akan otomatis diimport, diproses OCR-nya, dan ditambahkan ke library - sangat berguna untuk impor massal atau workflow otomatis.

Integrasi dan Ekstensi

Workflow ala Paperless: Gabungkan Paperclip dengan aplikasi scanner (Scanbot, Adobe Scan) yang mengirimkan email atau meng-upload langsung ke inbox Paperclip untuk pipeline otomatis paper ke digital yang dapat dicari.

Backup ke S3: Pakai rclone untuk mencerminkan volume data Paperclip ke Backblaze B2 atau bucket S3 lain:

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

Nginx Proxy Manager: Jika sudah menjalankan NPM, arahkan proxy ke paperclip:8080 dan aktifkan Let’s Encrypt dari GUI.

Authentik / Authelia: Tambahkan SSO di depan Paperclip dengan penyedia identitas untuk instalasi multi-user.

Tips Pemeliharaan

• Perbarui secara berkala: docker compose pull && docker compose up -d
• Pantau penggunaan disk: Output OCR dan thumbnail memakan ruang - siapkan alert df -h
• Cadangkan volume data: sebelum melakukan upgrade
• Tuning PostgreSQL: Untuk perpustakaan besar, tingkatkan work_mem dan max_connections di postgresql.conf

Ringkasan

Paperclip adalah salah satu pengelola dokumen self-hosted yang paling dikelola dengan baik. Untuk peng-deploy-an di VPS, Hetzner Cloud cocok untuk sebagian besar pengguna dengan biaya €4.15/bulan. Jika Anda membutuhkan penyimpanan besar untuk arsip dokumen, Contabo menyediakan 200GB NVMe seharga €5.99/bulan.

Gabungan kemudahan Docker, OCR otomatis, dan organisasi metadata menjadikan Paperclip pilihan menarik sebagai pengganti layanan dokumen cloud.

Lihat juga: Perbandingan VPS lengkap di selfhostvps.com