Cara Menjadi Host Sendiri Docmost di VPS (Panduan 2026)
Docmost adalah platform wiki kolaboratif dan dokumentasi sumber terbuka. Menjadi hosting sendiri di VPS memberikan Anda kepemilikan data penuh, domain kustom, dan tanpa biaya per kursi. Panduan ini mencakup pengaturan lengkap dari VPS Ubuntu baru hingga instansi Docmost yang berjalan dengan SSL dan Nginx.
Prasyarat
Sebelum memulai, Anda memerlukan:
- VPS yang menjalankan Ubuntu 22.04 atau 24.04 (setidaknya 1 vCPU, 2GB RAM disarankan)
- Domain atau subdomain yang diarahkan ke IP VPS Anda (misalnya,
docs.yourdomain.com) - Akses Root atau sudo ke server
- Docker dan Docker Compose terinstal
Penyedia VPS yang Direkomendasikan:
- Hetzner Cloud - โฌ4.15/bulan, 2 vCPU, 4GB RAM (nilai terbaik)
- Contabo VPS - โฌ5.99/bulan, 4 vCPU, 8GB RAM, 200GB NVMe
- DigitalOcean - $6/bulan, ramah pemula
Langkah 1: Sediakan VPS Anda
Buat VPS Ubuntu 22.04 yang baru. SSH sebagai root:
ssh root@ip-server-anda
Buat pengguna non-root dengan hak istimewa sudo (disarankan):
adduser deploy
usermod -aG sudo deploy
Langkah 2: Instal Docker dan Docker Compose
# Perbarui sistem
apt update && apt upgrade -y
# Instal Docker
curl -fsSL https://get.docker.com | sh
# Tambahkan pengguna Anda ke grup docker
usermod -aG docker deploy
# Verifikasi instalasi
docker --version
docker compose version
Keluar dan masuk kembali agar perubahan grup berlaku.
Langkah 3: Buat Direktori Docmost
mkdir -p /opt/docmost
cd /opt/docmost
Langkah 4: Tulis File Docker Compose
Buat /opt/docmost/docker-compose.yml:
version: '3'
services:
docmost:
image: docmost/docmost:latest
ports:
- "3000:3000"
environment:
DATABASE_URL: postgresql://docmost:password@db:5432/docmost
REDIS_URL: redis://redis:6379
depends_on:
- db
- redis
restart: unless-stopped
db:
image: postgres:16
environment:
POSTGRES_USER: docmost
POSTGRES_PASSWORD: password
POSTGRES_DB: docmost
volumes:
- pg_data:/var/lib/postgresql/data
restart: unless-stopped
redis:
image: redis:7
volumes:
- redis_data:/data
restart: unless-stopped
volumes:
pg_data:
redis_data:
Catatan Keamanan: Ganti
passworddengan password yang kuat dan acak sebelum menyebarkan.
Langkah 5: Mulai Docmost
cd /opt/docmost
docker compose up -d
Periksa bahwa semua kontainer berjalan:
docker compose ps
Anda harus melihat docmost, db, dan redis dalam status running. Periksa log jika ada yang gagal:
docker compose logs docmost
Langkah 6: Instal dan Konfigurasi Nginx
apt install nginx -y
Buat /etc/nginx/sites-available/docmost:
server {
listen 80;
server_name docs.yourdomain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl;
server_name docs.yourdomain.com;
ssl_certificate /etc/letsencrypt/live/docs.yourdomain.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/docs.yourdomain.com/privkey.pem;
client_max_body_size 100M;
location / {
proxy_pass http://localhost:3000;
proxy_http_version 1.1;
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;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 86400;
}
}
Aktifkan situs:
ln -s /etc/nginx/sites-available/docmost /etc/nginx/sites-enabled/
nginx -t
systemctl reload nginx
Langkah 7: Peroleh Sertifikat SSL
apt install certbot python3-certbot-nginx -y
certbot --nginx -d docs.yourdomain.com
Ikuti petunjuknya. Certbot akan secara otomatis memperbarui konfigurasi Nginx dengan jalur sertifikat dan mengatur perpanjangan otomatis.
Langkah 8: Konfigurasi Firewall
ufw allow OpenSSH
ufw allow 'Nginx Full'
ufw enable
Jangan buka port 3000 langsung - seluruh lalu lintas harus melalui Nginx.
Langkah 9: Login Pertama dan Pengaturan Workspace
- Buka
https://docs.yourdomain.comdi browser Anda - Anda akan melihat wizard setup Docmost saat kunjungan pertama
- Buat akun admin Anda (email + password)
- Beri nama workspace Anda
- Buat space pertama Anda (misalnya, โEngineeringโ, โProductโ, โHRโ)
- Undang anggota tim melalui panel Pengaturan
Memperbarui Docmost
Untuk menarik gambar terbaru dan memulai kembali:
cd /opt/docmost
docker compose pull
docker compose up -d
Strategi Cadangan
Cadangkan data PostgreSQL secara rutin:
docker exec docmost-db-1 pg_dump -U docmost docmost > backup_$(date +%Y%m%d).sql
Juga cadangkan volume Docker di /var/lib/docker/volumes/docmost_pg_data.
Pemecahan Masalah
| Masalah | Solusi |
|---|---|
| Kontainer tidak mulai | Periksa docker compose logs untuk error |
| 502 Bad Gateway | Docmost mungkin masih inisialisasi - tunggu 30 detik dan coba lagi |
| Error WebSocket | Pastikan header Upgrade dan Connection ada di konfigurasi Nginx |
| Koneksi DB ditolak | Periksa bahwa DATABASE_URL cocok dengan kredensial kontainer Postgres |
Langkah Selanjutnya
- Atur SMTP di pengaturan Docmost untuk notifikasi email
- Konfigurasi OIDC/SSO jika tim Anda menggunakan penyedia identitas
- Aktifkan snapshot otomatis volume Docker melalui penyedia VPS Anda
Untuk perbandingan penyedia VPS, lihat selfhostvps.com/en/best/.