# Instalasi ChatLoop v1.9.0

Panduan instalasi baru untuk macOS, Windows, dan Linux.

## Persiapan

- Go sesuai `go.mod` (minimal 1.25.8).
- Node.js minimal 22.12 dan npm.
- MySQL Server 8.x, database `db_wa_blast`, dan pengguna database yang memiliki izin pada database tersebut.
- Lisensi dari member area NgertiKode.

Ekstrak ZIP ke folder baru. Buka terminal pada folder yang berisi `package.json`
dan `go.mod`.

## Konfigurasi dan jalankan

```sh
npm run setup:env
npm run setup
```

Perintah pertama membuat `.env` dengan JWT dan password admin acak yang unik.
Nilainya tidak dicetak ke terminal. Buka `.env`, lalu sesuaikan `DB_HOST`,
`DB_PORT`, `DB_USER`, `DB_PASS`, dan `DB_NAME` dengan MySQL Anda. Isi `LICENSE_KEY`
dari member area atau pertahankan nilai yang sudah diberikan LMS.

Pertahankan `JWT_SECRET` dan `SUPERADMIN_PASSWORD` yang dibuat setup. Paket master
berisi template kosong; setup tidak menerbitkan lisensi. Jika `.env` sudah ada,
setup mempertahankannya dan melaporkan nama field yang belum valid.

```sh
npm run dev
```

- Dashboard: http://127.0.0.1:5173.
- Backend: http://127.0.0.1:3030.
- Username awal mengikuti `SUPERADMIN_USERNAME`, umumnya `superadmin`.
- Password awal adalah `SUPERADMIN_PASSWORD` pada `.env` milik instalasi Anda.

Sambungkan nomor WhatsApp dari aplikasi. Isi key AI melalui **Pengaturan AI**;
lihat [pengaturan pengetahuan](AI-KNOWLEDGE.md). Proses aplikasi harus tetap
berjalan agar jadwal dan balasan otomatis dapat diproses.

## Jika belum dapat berjalan

- Pastikan MySQL aktif dan nama database serta kredensial sudah sesuai.
- Jika port 3030 atau 5173 sedang digunakan, hentikan instance development lama.
- Jika lisensi ditolak, periksa lisensi melalui member area. Pertahankan identitas
  mesin instalasi; jangan mengubah verifikasi lisensi.
- Chrome/Chromium dapat diperlukan untuk crawler halaman yang memakai JavaScript.

Untuk instalasi yang sudah berisi data, ikuti [panduan pembaruan](UPDATE-v1.9.0.md).
Simpan `.env`, backup, database, dan sesi WhatsApp secara privat.