Panduan Pemasangan
Pemasangan memakan sekitar 15 menit. Jalankan perintah di bawah di server Anda, sebagai pengguna yang boleh memakai Docker.
1. Masuk ke Registri Paket
Paket WiTalk ada di registri pribadi kami. Masuk dengan ID server sebagai nama pengguna dan kunci lisensi sebagai kata sandi:
read -rsp 'Kunci lisensi: ' WT_KEY && echo
printf '%s' "$WT_KEY" | docker login talk.wiracode.com -u srv_xxxxxxxxxxxxxxxx --password-stdin
unset WT_KEY
Ganti srv_xxxxxxxxxxxxxxxx dengan ID server Anda. Docker menjawab Login Succeeded dan menyimpan kunci itu di ~/.docker/config.json untuk pembaruan nanti.
2. Ambil Paket
sudo mkdir -p /opt/wiratalk && sudo chown "$USER" /opt/wiratalk && cd /opt/wiratalk
docker run --rm --entrypoint tar talk.wiracode.com/wiratalk/server:0.6.0 -C /app/kit -cf - . | tar -xf -
Folder itu kini berisi pemasang wiratalk-install, perintah harian wiratalk, dan berkas Docker Compose.
3. Arahkan Domain
Lakukan ini sebelum menjalankan pemasang. Di langkah terakhirnya, pemasang menunggu agar WiTalk Hub bisa membuka server Anda di https://alamat-server-anda/.well-known/wiratalk (sampai 2 menit), jadi domain dan HTTPS harus sudah aktif. Dengan Caddy, pemasang lebih dulu menunggu sampai 5 menit sampai alamat itu menjawab lewat HTTPS dan menampilkan baris Masih menunggu selama itu.
Dengan Caddy: buat catatan DNS A (dan AAAA bila ada IPv6) untuk domain server ke alamat IP server ini, dan buka port 80 dan 443. Sertifikat dibuat sendiri dalam satu atau dua menit sesudah Caddy berjalan.
Dengan proxy atau tunnel Anda sendiri: arahkan ke alamat dan port yang akan Anda pilih saat pemasangan (bawaan 127.0.0.1:45215). Proxy harus mengisi header CF-Connecting-IP dengan alamat IP pengunjung dan membuang header CF-IPCity dan CF-IPCountry dari pengunjung. Cloudflare Tunnel sudah melakukannya sendiri. Contoh untuk nginx:
location / {
proxy_pass http://127.0.0.1:45215;
proxy_set_header Host $host;
proxy_set_header CF-Connecting-IP $remote_addr;
proxy_set_header CF-IPCity "";
proxy_set_header CF-IPCountry "";
proxy_http_version 1.1;
proxy_buffering off;
proxy_request_buffering off;
proxy_read_timeout 15m;
client_max_body_size 100m;
}
4. Jalankan Pemasang
./wiratalk-install
Pemasang menanyakan:
- nama perusahaan, ID server, dan kunci lisensi;
- alamat server, misalnya https://chat.perusahaan.co.id;
- cara HTTPS: Caddy di server ini, atau proxy atau tunnel Anda sendiri (untuk proxy, juga alamat dan port tempat server mendengar);
- penyimpanan berkas: bawaan, atau bucket S3 Anda;
- nama resmi perusahaan dan email kontak privasi, untuk kebijakan privasi server;
- negara tempat server dan cadangannya berada, kode dua huruf (bawaan ID);
- penyedia yang memproses data, per peran: hosting, cdn, storage, email, dan backup, misalnya hosting=PT Awan Contoh;cdn=Cloudflare, Inc. (bawaan: tidak ada). Daftar ini muncul di halaman privasi server Anda;
- email (SMTP) bila ada, dan bucket S3 untuk salinan cadangan bila ada;
- nama, nama pengguna, email, dan kata sandi admin pertama;
- apakah jadwal cadangan dipasang di crontab pengguna ini (bawaan: ya).
Sesudah ringkasan, pemasang bertanya Lanjutkan pemasangan? (Y/t). Lalu pemasang menulis pengaturan ke .env, menyiapkan basis data, menjalankan migrasi, menjalankan server, membuat admin pertama, menyiapkan cadangan otomatis, dan mendaftarkan server ke WiTalk Hub. Baris terakhir INSTALL_OK berarti semuanya selesai. INSTALL_INCOMPLETE berarti server sudah berjalan tetapi WiTalk Hub belum menerimanya dalam 2 menit sesudah alamat server menjawab. Itu bisa diselesaikan nanti tanpa memasang ulang: perbaiki penyebabnya (lihat di bawah), lalu jalankan ./wiratalk status sampai WiTalk Hub: ok. Server mencoba mendaftar lagi sendiri. INSTALL_FAILED diikuti nama langkah berarti pemasangan berhenti di langkah itu; pemasang menjelaskan cara memulai ulang.
5. Periksa
./wiratalk status
Semua baris harus sehat, dan WiTalk Hub: ok. Hub memeriksa https://alamat-server-anda/.well-known/wiratalk sebelum mendaftarkan server.
Bila WiTalk Hub Belum OK
- menunggu: server belum mendaftar atau Hub belum menjawab. Tunggu beberapa menit dan jalankan ./wiratalk status lagi.
- mati: server tidak memakai WiTalk Hub, karena tidak ada kunci lisensi atau alamat servernya bukan https di port 443. Periksa WT_LICENCE_KEY dan WT_PUBLIC_ORIGIN di .env, lalu jalankan ./wiratalk restart.
- gagal (WELL_KNOWN_FAILED...): Hub belum bisa membuka server Anda. Periksa DNS, HTTPS, dan proxy, lalu tunggu; server mencoba lagi sendiri (sesudah 30 detik, 1, 2, dan 5 menit, lalu tiap 10 menit). Dengan Caddy, kegagalan pertama wajar selama sertifikat belum terbit; jalankan ./wiratalk restart begitu https://alamat-server-anda terbuka di peramban.
- gagal (SERVER_ID_MISMATCH): WT_SERVER_ID bukan ID server yang dibuatkan untuk kunci lisensi ini. Salin ID dari email persetujuan ke .env, lalu jalankan ./wiratalk restart.
- gagal (LICENCE_MISMATCH): alamat server menjawab dengan ID server ini tetapi dengan kunci lisensi lain, biasanya karena domain mengarah ke server WiTalk lain (misalnya pemasangan lama yang masih berjalan). Arahkan domain ke server ini.
- ditolak (INVALID_LICENCE atau COMPANY_SUSPENDED): hubungi support@wiracode.com.
- gagal (network atau timeout): server tidak bisa menghubungi talk.wiracode.com. Periksa koneksi keluar server.
Sesudah Terpasang
Admin pertama masuk di aplikasi WiTalk dengan alamat server, nama pengguna, dan kata sandi yang dibuat saat pemasangan. Lanjutkan ke Panduan admin.