Cara Self-Host Paperless-ngx di VPS (Panduan Lengkap)

Self-hosting Paperless-ngx, sebuah sistem manajemen dokumen, di Virtual Private Server (VPS) dapat menyederhanakan alur kerja Anda dan meningkatkan privasi data. Panduan ini akan memandu Anda melalui langkah-langkah yang diperlukan untuk menginstal Paperless-ngx menggunakan Docker di VPS, sehingga dapat diakses oleh pengembang dan pecinta homelab.

Apa itu Paperless-ngx?

Paperless-ngx adalah aplikasi sumber terbuka yang memungkinkan Anda memindai, mengunggah, dan mengelola dokumen Anda dengan mudah. Dibangun di atas filosofi Paperless, varian modern ini menawarkan fitur yang lebih baik dan antarmuka yang lebih ramah pengguna. Dengan self-hosting, Anda tetap mengendalikan dokumen Anda tanpa bergantung pada layanan pihak ketiga.

Memilih Penyedia VPS

Sebelum memulai, Anda perlu memilih penyedia VPS. Berikut adalah perbandingan beberapa opsi teratas:

Anda dapat menemukan perbandingan VPS lengkap di sini.

Persyaratan Sistem

Sebelum pemasangan, pastikan VPS Anda memenuhi persyaratan berikut:

• Minimal 2GB RAM (disarankan 4GB)
• Penyimpanan SSD 20GB
• Nama domain (opsional tapi disarankan)
• Docker dan Docker Compose terinstal

Panduan Instalasi Langkah-demi-Langkah

Langkah 1: Siapkan VPS Anda

Provision VPS yang Anda pilih. Sebagai contoh, Anda bisa membuat instance baru di Hetzner Cloud seharga 4.15 EUR/bulan atau menggunakan Contabo dengan hanya 5.99 EUR/bulan.

1. Hubungkan ke server Anda melalui SSH:

   ssh root@alamat_ip_server_anda

2. Perbarui sistem Anda:

   apt update && apt upgrade -y

Langkah 2: Instal Docker dan Docker Compose

Anda perlu menginstal Docker dan Docker Compose di VPS Anda. Gunakan perintah berikut:

1. Instal Docker:

   apt install -y docker.io
   systemctl start docker
   systemctl enable docker

2. Instal Docker Compose:

   apt install -y docker-compose

Langkah 3: Siapkan Paperless-ngx

1. Buat direktori untuk Paperless-ngx:

   mkdir ~/paperless
   cd ~/paperless

2. Buat file docker-compose.yml:

   version: '3.7'
   services:
     paperless-ngx:
       image: ghcr.io/jfcherng/paperless-ngx:latest
       restart: always
       volumes:
         - ./data:/usr/src/paperless/data
       ports:
         - "8000:8000"
       environment:
         PAPERLESS_REDIS: redis://redis:6379
         PAPERLESS_DBHOST: db
         PAPERLESS_DBUSER: paperless
         PAPERLESS_DBPASS: password
     redis:
       image: redis:latest
       restart: always
     db:
       image: postgres:latest
       restart: always
       environment:
         POSTGRES_USER: paperless
         POSTGRES_PASSWORD: password
         POSTGRES_DB: paperless
       volumes:
         - ./postgres:/var/lib/postgresql/data

3. Jalankan Paperless-ngx:

   docker-compose up -d

Langkah 4: Mengakses Aplikasi

Setelah kontainer berjalan, Anda bisa mengakses Paperless-ngx melalui browser dengan pergi ke http://alamat_ip_server_anda:8000. Untuk penggunaan domain yang sebenarnya, disarankan mengatur reverse proxy menggunakan Nginx atau Traefik.

FAQ

1. Apa manfaat dari self-hosting Paperless-ngx?

Self-hosting Paperless-ngx di VPS memberikan kontrol data dan privasi yang lebih baik, karena dokumen Anda disimpan di server sendiri bukan di layanan pihak ketiga. Pendekatan ini memastikan Anda mengelola cadangan dan praktik keamanan sendiri. Selain itu, Anda bisa menyesuaikan aplikasi sesuai kebutuhan alur kerja tanpa batasan dari solusi hosting.

2. Berapa banyak penyimpanan yang saya butuhkan untuk Paperless-ngx?

Meskipun penyimpanan minimal yang direkomendasikan sekitar 20GB, ini tergantung pada jumlah dokumen yang akan Anda kelola. Jika Anda berurusan dengan file resolusi tinggi atau banyak dokumen, pertimbangkan untuk menambah kapasitas penyimpanan Anda. Menggunakan layanan VPS seperti DigitalOcean atau Vultr untuk opsi penyimpanan yang skalabel juga merupakan pilihan yang bijak untuk file yang terus bertambah besar.

3. Bisakah saya menjalankan aplikasi lain di VPS yang sama?

Ya, Anda dapat menjalankan beberapa aplikasi di VPS yang sama dengan menggunakan Docker untuk memisahkan setiap layanan. Setiap aplikasi dapat berjalan di kontainer sendiri, menghindari konflik sumber daya. Namun, pastikan VPS Anda memiliki sumber daya (CPU, RAM, dan disk space) yang cukup untuk menjalankan aplikasi tersebut secara bersamaan. Disarankan untuk secara rutin memantau performa server Anda agar terhindar dari overload.

Sebagai kesimpulan, self-hosting Paperless-ngx di VPS adalah proyek yang bermanfaat yang menawarkan berbagai keuntungan untuk manajemen dokumen, terutama bagi pengembang dan penggemar homelab. Dengan mengikuti panduan ini, Anda dapat mencapai sistem yang mandiri dan efisien untuk mengatur dokumen Anda secara aman. --- END ---