vicca
vicca
install guide
 ← Member portal

Install Guide — Lengkap

Detail step-by-step + troubleshooting. Total waktu ~30 menit kalau ini pertama kali lo pegang VPS.

Yang lo butuh

Step 1 — Beli VPS Hostinger

  1. Buka hostinger.co.id/vps-hosting
  2. Pilih KVM 1 (1 vCPU, 4 GB RAM, 50 GB disk) — Rp 49.000/bulan
  3. Pilih billing cycle 12 bulan (diskon ~30%)
  4. Saat checkout, bayar via QRIS / bank transfer (tanpa kartu kredit pun bisa)
  5. Setelah bayar, di Hostinger panel pilih OS template: Ubuntu 24.04 LTS clean
  6. Pilih region Singapore (terdekat ke Indonesia)
  7. Set root password (catat baik-baik)
  8. Tunggu ~2 menit, VPS ready. Lo akan dapat IP address di Hostinger panel.

Step 2 — SSH ke VPS

Di Mac

  1. Buka Terminal (Cmd+Space → "Terminal")
  2. Paste: ssh root@YOUR_VPS_IP (ganti YOUR_VPS_IP dengan IP dari Hostinger)
  3. Jika ditanya "Are you sure…" → ketik yes + enter
  4. Paste root password (cursor gak akan keliatan, itu normal)

Di Windows

  1. Buka PowerShell atau Windows Terminal (search "PowerShell" di Start menu)
  2. Paste perintah yang sama dengan Mac

Step 3 — Install Vicca

Setelah lo ke-SSH dan dapat prompt root@vps-name:~#, paste:

curl -fsSL https://vicca.id/install.sh | sudo bash

Script ini akan:

Total: ~5 menit. Sambil nunggu, buka tab baru: kapso.ai dan daftar akun BSP.

Step 4 — Setup HTTPS (production)

By default Vicca jalan di http://IP:8090. Untuk production lo butuh HTTPS. Cara paling gampang: setup subdomain + Let's Encrypt.

Beli atau pakai subdomain

Kalau lo punya domain (misalnya brandlo.com), buat subdomain vicca.brandlo.com via DNS, point A record ke IP VPS lo.

Install nginx + certbot

apt update && apt install -y nginx certbot python3-certbot-nginx

Bikin nginx vhost

cat > /etc/nginx/sites-available/vicca <<'EOF' server { listen 80; server_name vicca.brandlo.com; location / { proxy_pass http://127.0.0.1:8090; 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; } } EOF ln -s /etc/nginx/sites-available/vicca /etc/nginx/sites-enabled/ nginx -t && systemctl reload nginx

Generate HTTPS cert

certbot --nginx -d vicca.brandlo.com

Ikutin prompt (ketik email lo, accept TOS). Sertifikat auto-renew via cron.

Step 5 — Konfigurasi BSP & LLM

Kapso (WhatsApp BSP)

  1. Daftar di kapso.ai
  2. Tambahkan WhatsApp number lo (butuh approval Meta — 3-7 hari, butuh PT untuk display name)
  3. Di Kapso panel, ambil: API key, Phone Number ID
  4. Set webhook URL: https://vicca.brandlo.com/api/wa/webhook
  5. Set verify token (string random apa aja, contoh: my-secret-token-123) — catat ini

OpenRouter (LLM)

  1. Daftar di openrouter.ai
  2. Top-up $5 (bisa via Stripe — Apple Pay, Google Pay, atau CC)
  3. Generate API key di openrouter.ai/keys

Paste semua di dashboard Vicca

  1. Buka https://vicca.brandlo.com
  2. Onboarding wizard akan keluar (kalau pertama kali)
  3. Buat admin password
  4. Paste license key + email
  5. Setting brand name + voice
  6. Setelah masuk dashboard, ke Settings → WhatsApp / BSP: paste Kapso API key, Phone Number ID, verify token, app secret
  7. Ke Settings → LLM: paste OpenRouter key
  8. Ke WhatsApp tab: toggle Responder ON, dry-run ON, LLM ON
  9. Test: kirim WhatsApp ke nomor lo, cek di dashboard apakah message masuk + proposed reply muncul. Kalau iya, toggle dry-run OFF → live.

Instagram setup (opsional, kalau lo pakai)

  1. Pastikan Instagram lo sudah Professional Account + linked ke Facebook Page
  2. Di developers.facebook.com, bikin Meta App
  3. Tambahkan produk Instagram Graph API
  4. Generate page access token, app secret, business ID
  5. Set webhook URL: https://vicca.brandlo.com/api/ig/webhook
  6. Subscribe ke field messages dan comments
  7. Paste credentials di dashboard Vicca → Settings → Instagram

Troubleshooting

"Permission denied (publickey)" saat SSH

Lo pakai password auth tapi belum enable. Coba: ssh -o PreferredAuthentications=password root@YOUR_IP

Install script gagal di middle

Cek log: journalctl -u docker -n 50. Kalau Docker install gagal, jalanin manual: curl -fsSL https://get.docker.com | sh

Dashboard gak ke-load (port 8090)

  1. Cek service jalan: cd /opt/vicca/deploy && docker compose ps
  2. Lihat log: docker compose logs -f vicca
  3. Restart: docker compose restart
  4. Firewall: pastikan port 8090 (atau 80/443 kalau lo udah pakai nginx) open di Hostinger panel

Webhook Kapso/Meta gak masuk

Bot kirim reply tapi customer gak terima

LLM gak respon

Update Vicca

Selama window update lo masih aktif (6-12 bulan tergantung tier), tinggal run:

curl -fsSL https://vicca.id/install.sh | sudo bash

Script idempotent — kalau ada update, dia download + rebuild + restart. State + config lo gak hilang (volume Docker preserved).

Backup

State Vicca ada di Docker volume vicca_state. Backup:

docker run --rm -v vicca_state:/data -v $(pwd):/backup ubuntu tar czf /backup/vicca-backup-$(date +%F).tar.gz /data

Restore (di VPS baru): copy file backup ke sana, lalu:

docker volume create vicca_state docker run --rm -v vicca_state:/data -v $(pwd):/backup ubuntu tar xzf /backup/vicca-backup-YYYY-MM-DD.tar.gz -C /

Next steps setelah live

Butuh bantuan lebih? Email hello@vicca.id atau Discord community.