> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalasi

> Instal GOWA dengan Docker, Docker Compose, biner rilis, atau dari kode sumber, lalu jalankan di belakang reverse proxy.

![Gambaran Umum Deployment dan Akses GOWA](https://mintcdn.com/gowa-docs/xwa06XWUO2vnG9_f/images/GOWA-Deployment-and-Access-Overview.png?fit=max\&auto=format\&n=xwa06XWUO2vnG9_f\&q=85\&s=dc847e074e7578d3cfb8c83f1d756040)

GOWA didistribusikan sebagai satu biner. REST API, webhook, dasbor, dan endpoint MCP semuanya dijalankan dengan `whatsapp rest`.

## Persyaratan

| Komponen | Kegunaan |
| - | - |
| FFmpeg | Konversi media (video, pesan suara). Disertakan dalam image Docker. |
| libwebp tools (`cwebp`, `dwebp`, `webpmux`) | Stiker, termasuk WebP animasi. Disertakan dalam image Docker. |
| Go 1.26+ | Hanya untuk membangun dari kode sumber. |

Platform yang didukung: Linux (amd64, arm64, armv7, 386), macOS (Intel, Apple Silicon), Windows (amd64, 386; disarankan menggunakan WSL).

## Docker

Image diterbitkan di Docker Hub dan GHCR:

* `aldinokemal2104/go-whatsapp-web-multidevice`
* `ghcr.io/aldinokemal/go-whatsapp-web-multidevice`

```bash theme={null}
docker volume create gowa_storages
docker volume create gowa_statics

docker run -d --name gowa --restart always \
  -p 3000:3000 \
  -v gowa_storages:/app/storages \
  -v gowa_statics:/app/statics \
  -e APP_BASIC_AUTH=admin:changeme \
  aldinokemal2104/go-whatsapp-web-multidevice:latest
```

* `/app/storages` menyimpan basis data SQLite (sesi, riwayat chat, jadwal, OAuth). Kehilangannya akan memutus penautan semua perangkat.
* `/app/statics` menyimpan gambar QR, unggahan, dan media yang diunduh.
* Perintah bawaannya adalah `rest`. Berikan flag setelahnya, misalnya `... go-whatsapp-web-multidevice rest --autoreply="Away"`.
* Entrypoint memperbaiki kepemilikan volume dan menurunkan hak akses ke `gowauser` (UID 20001, GID 20000).
* Waktu kontainer menggunakan UTC (`TZ=UTC`). Ubah `TZ` jika Anda memerlukan stempel waktu lokal pada log.

### Docker Compose

```yaml docker-compose.yml theme={null}
services:
  gowa:
    image: aldinokemal2104/go-whatsapp-web-multidevice:latest
    container_name: gowa
    restart: always
    ports:
      - "3000:3000"
    environment:
      APP_BASIC_AUTH: admin:changeme
      WHATSAPP_WEBHOOK: https://example.com/wa-hook
      WHATSAPP_WEBHOOK_SECRET: ${WHATSAPP_WEBHOOK_SECRET}
    volumes:
      - gowa_storages:/app/storages
      - gowa_statics:/app/statics

volumes:
  gowa_storages:
  gowa_statics:
```

Buat kunci webhook tetap dengan `openssl rand -hex 32` dan tetapkan `WHATSAPP_WEBHOOK_SECRET` di shell atau `.env` Compose sebelum menjalankan contoh ini.

Berkas `docker-compose.yml` bawaan repositori membangun image dari `docker/golang.Dockerfile` dan membaca `src/.env`. Gunakan jika Anda ingin membangun secara lokal: `cp src/.env.example src/.env && docker compose up -d --build`.

## Biner rilis

Unduh arsip dari [GitHub Releases](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/latest). Arsip diberi nama `whatsapp_<version>_<os>_<arch>.zip`, misalnya:

```bash theme={null}
curl -fLO https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases/download/v9.9.0/whatsapp_9.9.0_linux_amd64.zip
unzip whatsapp_9.9.0_linux_amd64.zip
chmod +x whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

Instal alat media pada host:

```bash theme={null}
# Debian/Ubuntu
sudo apt install ffmpeg webp
# macOS
brew install ffmpeg webp
```

Verifikasi hasil unduhan dengan `checksums.txt` dari rilis yang sama. `./whatsapp version` menampilkan versi; `./whatsapp --help` mencantumkan semua flag.

## Dari kode sumber

```bash theme={null}
git clone https://github.com/aldinokemal/go-whatsapp-web-multidevice.git
cd go-whatsapp-web-multidevice/src
cp .env.example .env    # optional
go build -o whatsapp
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password
```

Di macOS, jalankan juga `export CGO_CFLAGS_ALLOW="-Xpreprocessor"` sebelum membangun.

### ARM tanpa toolchain C

Tag build `purego` memilih driver SQLite Go murni, sehingga Anda dapat melakukan kompilasi silang dengan CGO dinonaktifkan:

```bash theme={null}
# Raspberry Pi 2/3/4 (ARMv7)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=7 go build -tags purego -o whatsapp-armv7
# Raspberry Pi Zero/1 (ARMv6)
CGO_ENABLED=0 GOOS=linux GOARCH=arm GOARM=6 go build -tags purego -o whatsapp-armv6
```

## Penyimpanan

Secara bawaan, semua data disimpan dalam SQLite di `storages/`:

| Data | Bawaan | Pengaturan |
| - | - | - |
| Sesi dan kunci WhatsApp | `file:storages/whatsapp.db` | `DB_URI` |
| Cache kunci sesi (opsional, basis data terpisah) | menggunakan `DB_URI` | `DB_KEYS_URI` |
| Riwayat chat, registri perangkat, jadwal | `file:storages/chatstorage.db` | tidak dapat dikonfigurasi |
| Klien dan token OAuth MCP | `file:storages/oauth.db` | `MCP_OAUTH_DB_URI` |

`DB_URI` juga menerima PostgreSQL, misalnya `postgres://user:pass@host:5432/gowa?sslmode=verify-full`. Penyimpanan sesi PostgreSQL jarak jauh secara bawaan memverifikasi sertifikat jika tidak ada mode TLS efektif yang ditetapkan. Pengaturan TLS eksplisit dari URI, lingkungan, atau layanan PostgreSQL tetap berlaku. Lihat [konfigurasi penyimpanan](https://gowa-docs.mintlify.site/id/configuration.md#penyimpanan).

GOWA membuat berkas SQLite dengan izin `0600` yang hanya mengizinkan pemilik mengaksesnya, dan direktori induk baru dengan izin `0700`. Izin direktori yang sudah ada tetap dipertahankan. Cadangkan `storages/` (atau PostgreSQL beserta `storages/`) agar perangkat tetap tertaut setelah pembangunan ulang. Perlakukan cadangan ini sebagai kredensial.

## Di belakang reverse proxy

Sajikan GOWA di bawah subpath dengan `APP_BASE_PATH`, dan percayai header yang diteruskan proxy melalui `APP_TRUSTED_PROXIES`:

```bash theme={null}
./whatsapp rest --basic-auth=admin:replace-with-a-strong-password \
  --base-path=/gowa --trusted-proxies=10.0.0.0/8
```

```nginx theme={null}
location /gowa/ {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;     # WebSocket at /gowa/ws
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    client_max_body_size 100m;                  # largest upload GOWA accepts
}
```

`/health` tetap berada di root (`/health`, bukan `/gowa/health`) agar probe berfungsi terlepas dari base path.

Pelindung origin browser memerlukan host publik. Pertahankan `Host` seperti di atas, atau kirim `X-Forwarded-Host` dari proxy tepercaya. Dasbor yang dihosting terpisah memerlukan origin persisnya dalam `APP_TRUSTED_ORIGINS` atau `APP_CORS_ALLOWED_ORIGINS`. Wildcard tidak memberikan izin untuk mutasi atau WebSocket. Sajikan dasbor melalui HTTP atau HTTPS karena halaman `file://` memiliki origin `null` yang tidak dipercaya.

Listener bawaan menolak dijalankan tanpa kredensial Basic Auth yang lengkap. Aktifkan `APP_ALLOW_UNAUTHENTICATED=true` hanya jika proxy mengautentikasi pemanggil dan klien tidak dapat melewatinya. Untuk pengembangan lokal tanpa autentikasi, gunakan alamat bind `APP_HOST=127.0.0.1`.

## Verifikasi

```bash theme={null}
curl http://localhost:3000/health                      # OK, no auth needed
curl -u admin:changeme http://localhost:3000/app/info  # server info, no device needed
curl -u admin:changeme http://localhost:3000/devices   # registered devices
```

`/health` mengembalikan `OK` setelah penyimpanan diinisialisasi. Endpoint ini tidak melaporkan apakah ada akun WhatsApp yang terhubung; gunakan `GET /devices/{device_id}/status` untuk memeriksanya.

## Memperbarui versi

Cadangkan `storages/`, ambil image atau biner baru, lalu jalankan ulang. Baca [catatan rilis](https://github.com/aldinokemal/go-whatsapp-web-multidevice/releases) terlebih dahulu untuk mengetahui perubahan yang merusak kompatibilitas. Perubahan penting: v6 mewajibkan subperintah `rest`, v7 memindahkan biner ke arsip GoReleaser, v8 menambahkan dukungan multi-perangkat (panggilan dalam cakupan perangkat memerlukan `X-Device-Id` jika ada lebih dari satu perangkat), dan mode mandiri `whatsapp mcp` (`:8080/sse`) digantikan oleh endpoint `/mcp` pada server REST.


## Related topics

- [Mulai Cepat](https://gowa-docs.mintlify.site/id/quickstart.md)
- [Praktik Terbaik untuk Produksi](https://gowa-docs.mintlify.site/id/advanced/best-practices.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.