Independent testing Updated April 2026 387 self-hosting guides 5 VPS providers tested

guide

Cara Menjadi Host Sendiri Docmost di VPS (Panduan 2026)

Panduan langkah demi langkah untuk self-hosting Docmost di VPS dengan Docker Compose, PostgreSQL, Redis, dan reverse proxy Nginx. Termasuk panduan login pertama.

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:

Penyedia VPS yang Direkomendasikan:

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 password dengan 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

  1. Buka https://docs.yourdomain.com di browser Anda
  2. Anda akan melihat wizard setup Docmost saat kunjungan pertama
  3. Buat akun admin Anda (email + password)
  4. Beri nama workspace Anda
  5. Buat space pertama Anda (misalnya, โ€œEngineeringโ€, โ€œProductโ€, โ€œHRโ€)
  6. 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

MasalahSolusi
Kontainer tidak mulaiPeriksa docker compose logs untuk error
502 Bad GatewayDocmost mungkin masih inisialisasi - tunggu 30 detik dan coba lagi
Error WebSocketPastikan header Upgrade dan Connection ada di konfigurasi Nginx
Koneksi DB ditolakPeriksa bahwa DATABASE_URL cocok dengan kredensial kontainer Postgres

Langkah Selanjutnya

Untuk perbandingan penyedia VPS, lihat selfhostvps.com/en/best/.