Cara Menjadi Self-Host HedgeDoc di VPS (Panduan Lengkap)

Pendahuluan

HedgeDoc adalah editor markdown kolaboratif yang memungkinkan banyak pengguna untuk mengedit dokumen secara bersamaan dalam waktu nyata. Biasanya digunakan untuk pencatatan dan dokumentasi di antara tim. Melakukan self-host HedgeDoc di Virtual Private Server (VPS) memberi Anda kendali penuh atas data Anda dan menjamin privasi. Dalam panduan ini, kami akan memandu Anda melalui langkah-langkah untuk menginstal HedgeDoc di VPS menggunakan Docker.

Prasyarat

Sebuah VPS: Pilih penyedia VPS yang sesuai. Berikut perbandingan singkat beberapa opsi populer:

Provider	Harga Bulanan	RAM	Ruang Disk	CPU
Contabo VPS	5,99 EUR	4 GB	50 GB	2 Cores
Hetzner Cloud	4,15 EUR	2 GB	20 GB	1 Core
DigitalOcean	6 USD	2 GB	1 vCPU	1 Core
Vultr	6 USD	2 GB	1 vCPU	1 Core
Linode (Akamai)	5 USD	2 GB	1 vCPU	1 Core

Untuk perbandingan lengkap berbagai penyedia VPS, cek perbandingan VPS lengkap kami.

Akses SSH: Pastikan Anda dapat mengakses VPS Anda melalui SSH.
Docker dan Docker Compose: Pastikan Docker dan Docker Compose terinstal di VPS Anda. Anda dapat menginstalnya dengan perintah berikut:
```
sudo apt update
sudo apt install -y docker.io docker-compose
```

Langkah 1: Menyiapkan Lingkungan HedgeDoc

Buat direktori untuk HedgeDoc:
```
mkdir ~/hedgedoc
cd ~/hedgedoc
```

Buat file docker-compose.yml di direktori hedgedoc. Tambahkan konfigurasi berikut untuk menyiapkan HedgeDoc dengan PostgreSQL sebagai database:

version: '3.1'

services:
  hedgedoc:
    image: hedgedoc/hedgedoc:latest
    environment:
      - CMD_URI=https://your-domain.com
      - DB_TYPE=postgres
      - DB_HOST=db
      - DB_PORT=5432
      - DB_USER=hedgedoc
      - DB_PASS=hedgedoc_password
      - DB_NAME=hedgedoc
    ports:
      - '3000:3000'
    depends_on:
      - db

  db:
    image: postgres:latest
    environment:
      - POSTGRES_USER=hedgedoc
      - POSTGRES_PASSWORD=hedgedoc_password
      - POSTGRES_DB=hedgedoc
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

Ganti your-domain.com dengan domain aktual yang akan Anda gunakan untuk mengakses HedgeDoc.

Langkah 2: Menjalankan HedgeDoc

Mulai aplikasi HedgeDoc menggunakan Docker Compose:
```
docker-compose up -d
```
Periksa bahwa HedgeDoc berjalan dengan benar melalui log:
```
docker-compose logs -f
```
Secara default, HedgeDoc dapat diakses di http://your-server-ip:3000. Untuk lingkungan produksi, disarankan menyiapkan reverse proxy.

Langkah 3: Menyiapkan Reverse Proxy dengan Nginx

Install Nginx:
```
sudo apt install -y nginx
```

Buat konfigurasi baru untuk HedgeDoc:

sudo nano /etc/nginx/sites-available/hedgedoc

Tambahkan konfigurasi berikut:

server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Aktifkan konfigurasi tersebut:

sudo ln -s /etc/nginx/sites-available/hedgedoc /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

Langkah 4: Mengamankan HedgeDoc dengan SSL

Untuk mengamankan instansi HedgeDoc Anda, Anda dapat menggunakan Let’s Encrypt. Instal Certbot:
```
sudo apt install -y certbot python3-certbot-nginx
```
Jalankan Certbot untuk mendapatkan SSL untuk domain Anda:
```
sudo certbot --nginx -d your-domain.com
```

Pertanyaan Umum

1. Apa manfaat melakukan self-host HedgeDoc?

Self-host HedgeDoc memberi Anda kendali tak tertandingi atas data dan privasi Anda. Berbeda dengan opsi berbasis cloud, ketika Anda self-host, Anda mengelola pembaruan keamanan dan kustomisasi sesuai kebutuhan. Pengaturan ini sangat penting bagi pengembang dan homelabbers yang membutuhkan kepatuhan terhadap proses pengelolaan data tertentu atau ingin mengintegrasikan HedgeDoc ke dalam sistem yang lebih besar secara lancar.

2. Apakah saya bisa menjalankan HedgeDoc di VPS dengan spesifikasi rendah?

Ya, HedgeDoc dapat berjalan secara efisien di VPS dengan spesifikasi rendah, asalkan memenuhi syarat sistemnya. Untuk operasi dasar, VPS dengan 2 GB RAM dan ruang disk minimal sudah cukup. Namun, untuk instance yang lebih besar atau kolaborasi dengan banyak pengguna, pertimbangkan VPS dengan setidaknya 4 GB RAM dan 50 GB ruang disk agar performa tetap lancar. Struktur harga penyedia seperti Contabo dan Hetzner dapat memenuhi kebutuhan ini secara terjangkau.

3. Bagaimana cara memperbarui instalasi HedgeDoc saya?

Pembaharuan HedgeDoc cukup mudah berkat setup Docker-nya. Anda bisa menarik image terbaru dan memulai ulang kontainer:

docker-compose pull
docker-compose up -d

Setelah menjalankan perintah ini, penting untuk secara rutin memeriksa catatan rilis HedgeDoc untuk perubahan atau langkah migrasi yang diperlukan agar operasi tetap lancar. Anda juga bisa merujuk ke dokumentasi HedgeDoc untuk detail spesifik mengenai pembaruan versi.

Kesimpulan

Self-host HedgeDoc di VPS memungkinkan Anda mendapatkan manfaat dari editor markdown yang kuat sambil mempertahankan kendali penuh atas lingkungan Anda. Dengan langkah-langkah setup yang dijelaskan di atas, Anda sekarang dapat menginstal, mengkonfigurasi, dan mengamankan HedgeDoc secara efektif. Nikmati kolaborasi waktu nyata tanpa mengorbankan privasi atau integritas data.