vicca
vicca
install guide
 ← Member portal

Install Guide, Lengkap

Detail step by step dan troubleshooting. Total waktu ~30 menit jika ini pertama kali Anda memegang VPS.

Yang Anda butuhkan

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. Anda akan mendapat 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 tidak akan terlihat, itu normal)

Di Windows

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

Step 3: Install Vicca

Setelah Anda masuk via SSH dan mendapat prompt root@vps-name:~#, paste:

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

Script ini akan:

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

Step 4: Setup HTTPS (production)

Secara default Vicca berjalan di http://IP:8090. Untuk production Anda butuh HTTPS. Cara paling mudah: setup subdomain dan Let's Encrypt.

Beli atau gunakan subdomain

Jika Anda punya domain (misalnya brandlo.com), buat subdomain vicca.brandlo.com via DNS, arahkan A record ke IP VPS Anda.

Install nginx + certbot

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

Buat 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

Ikuti prompt (ketik email Anda, accept TOS). Sertifikat auto-renew via cron.

Step 5: Konfigurasi BSP & LLM

Kapso (WhatsApp BSP)

  1. Daftar di kapso.ai
  2. Tambahkan WhatsApp number Anda (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 acak apa saja, 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 muncul (jika 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 Anda, cek di dashboard apakah message masuk dan proposed reply muncul. Jika iya, toggle dry run OFF → live.

Instagram setup (opsional, jika Anda menggunakannya)

  1. Pastikan Instagram Anda sudah Professional Account dan terhubung ke Facebook Page
  2. Di developers.facebook.com, buat 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

Anda memakai password auth tapi belum diaktifkan. Coba: ssh -o PreferredAuthentications=password root@YOUR_IP

Install script gagal di tengah

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

Dashboard tidak ter-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 jika Anda sudah memakai nginx) terbuka di Hostinger panel

Webhook Kapso/Meta tidak masuk

Bot kirim reply tapi customer tidak menerima

LLM tidak merespons

Update Vicca

Selama masa update Anda masih aktif (6-12 bulan tergantung tier), tinggal jalankan:

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

Script idempotent, jika ada update, ia akan download, rebuild, dan restart. State dan config Anda tidak 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 /

Langkah berikutnya setelah live

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