Panduan Berdasarkan Paket Lisensi Anda
Paket Mandiri (Rp7,9 jt)
100% dikerjakan tim IT venue Anda mengikuti Bab 1-3 + 1 sesi orientasi online (60 menit).
Paket Plus & Multi Cabang
Bab 1-3 dikerjakan terima beres oleh tim kami sampai live; Bab 4-13 menjadi referensi operasional harian.
VPS Ops (Rp200 rb/bln) vs Software Care (Rp3,6 jt/th)
VPS Ops membantu pemantauan server & backup mingguan (Bab 4-6 & 10); Software Care memberikan rilis fitur baru di tahun ke-2+ (Bab 12).
Installer publik sedang disiapkan
Panduan sudah dapat dibaca. Mulai pemasangan setelah Anda menerima installer resmi, checksum, dan license key dari tim Amanah.
1. Persiapan
Gunakan VPS Ubuntu 24.04 LTS, arsitektur amd64/x86_64, dengan akses root atau sesi sudo -i. Image rilis pelanggan saat ini ditargetkan ke linux/amd64; server ARM tidak termasuk jalur instalasi ini.
Siapkan:
- Domain/subdomain booking milik venue, misalnya
booking.venue.example. Domain aplikasi pelanggan berbeda dari domain pusat lisensi Amanah. - DNS A yang menuju IP publik VPS. Jika memakai AAAA, IPv6-nya juga harus menuju VPS yang sama dan benar-benar melayani aplikasi.
- Port TCP 80/443 masuk ke VPS untuk Caddy/HTTPS, serta akses SSH operator. PostgreSQL, backend, frontend, dan WAHA tidak perlu port publik.
- Koneksi keluar untuk registry image, sertifikat HTTPS, pusat lisensi, dan provider yang dipakai (payment gateway, WAHA, Telegram, email, atau AI).
- Email pemilik, password admin unik (minimal 12 karakter, maksimal 128 byte UTF-8), nama venue dan license key resmi. Simpan rahasia di pengelola kata sandi.
- Kapasitas CPU/RAM/disk sesuai tier rekomendasi di Data Center Jakarta:
- 1 Lokasi (Web Chat & Telegram saja): minimal
2 vCPU / 2-4 GB RAM / 40-60 GB SSD NVMe. - 1 Lokasi Lengkap (Web + WhatsApp + Asisten AI + backup harian): rekomendasi
2-4 vCPU / 4-8 GB RAM / 60-100 GB SSD NVMe. - Multi-Cabang (2-5+ cabang dalam 1 server pusat & domain utama): rekomendasi
4-8 vCPU / 8-16 GB RAM / 100-160 GB SSD NVMe.
Jangan menganggap "lapangan tak terbatas" pada hak lisensi sebagai RAM atau disk VPS tanpa batas.
- Tujuan backup terenkripsi di luar VPS serta jadwal downtime untuk pembuatan backup konsisten.
Rilis resmi menggunakan image publik yang dipatok dengan digest. Installer menarik image tanpa akun GitHub atau docker login; fitur operasional tetap memerlukan lisensi yang sah.
Pelanggan tidak perlu source aplikasi atau compiler. Pada Ubuntu 24.04 baru, installer menyiapkan Python, sertifikat sistem, Docker Engine, dan Compose v2 dari repository resmi bila belum tersedia. Paket Docker lama yang bertabrakan tidak dihapus otomatis; operator perlu menanganinya sebelum melanjutkan. Siapkan sedikitnya 10 GiB disk kosong untuk pemasangan awal; kapasitas produksi mengikuti beban venue. Python 3.10+ dibutuhkan untuk menjalankan helper release.py secara langsung.
2. Terima dan jalankan satu berkas installer
Nama executable dalam contoh adalah amanah-installer. Gunakan nama dan checksum dari penyerahan rilis yang sebenarnya. Verifikasi SHA-256 dengan nilai yang diterima melalui saluran resmi sebelum menjalankannya sebagai root:
sha256sum /root/amanah-installerSetelah checksum cocok, pasang executable pada lokasi yang mudah dipakai ulang:
install -m 0755 /root/amanah-installer /usr/local/bin/amanah-installer
amanah-installer install --directory /opt/amanah-sportIkuti prompt installer untuk konfigurasi yang diminta. Gunakan hostname tanpa https://, port, atau path jika prompt meminta domain. Masukkan license key/password pada prompt yang tersedia; jangan menaruhnya dalam command line, tangkapan layar, atau tiket dukungan.
Wizard juga menawarkan integrasi opsional. Pilih hanya provider yang akan digunakan venue:
| Pilihan | Diisi saat instalasi | Onboarding yang masih perlu dilakukan |
|---|---|---|
| Aktifkan layanan messaging lokal | Pasangkan nomor di admin dan uji kirim/terima | |
| Login Google | OAuth client ID dan secret | Daftarkan origin dan https://booking.venue.example/api/auth/google/callback di Google, lalu uji login |
| Telegram | Bot ID angka untuk login, opsional | Hubungkan bot/sesi melalui admin dan izinkan domain login pada provider |
| Pembayaran | Manual, Midtrans, atau Xendit | Isi kredensial dan mode sandbox/produksi pada pengaturan cabang; uji transaksi serta callback |
| None, SMTP, Resend, atau SendGrid; pengirim terverifikasi dan kredensial yang sesuai | Verifikasi DNS pengirim dan uji pengiriman melalui aplikasi |
Integrasi yang dilewati dapat diatur kemudian. Memilih provider tidak otomatis mengirim pesan atau pembayaran uji. AI dan Web Push tetap termasuk checklist onboarding di admin.
Installer harus memverifikasi manifest rilis yang ditandatangani, identitas produk, platform, expiry manifest, checksum/ukuran ZIP, dan marker rilis pelanggan sebelum menjalankan paket. Manifest resmi direncanakan di https://download.amanahsport.cloud/releases/stable.jws. Mengunduh ZIP berhasil belum berarti isi paket layak dijalankan jika pemeriksaan tanda tangan gagal.
Reservasi license key hanya mengikat instalasi dan memberi izin setup; reservasi tidak memulai trial. Masa 30 hari dimulai oleh aktivasi setelah tahap kesiapan instalasi berhasil. Catat waktu mulai/akhir yang benar-benar ditampilkan server lisensi. Bila respons aktivasi terputus, percobaan berikutnya mengambil periode yang sama, bukan memperpanjang trial.
Jika terminal/SSH terputus pada tahap yang dapat dilanjutkan:
amanah-installer resume --directory /opt/amanah-sportJika inisialisasi DB sudah selesai tetapi journal belum tersimpan, resume memeriksa marker selesai, migrasi, dan identitas instalasi sebelum melanjutkan; data tidak diinisialisasi ulang.
Jika manifest yang tersimpan kedaluwarsa, resume mengambil manifest resmi baru dan hanya meneruskan paket yang sama: versi, hash, ukuran, platform, dan kontraknya harus cocok. Perbedaan paket tidak dianggap izin untuk mengganti instalasi. Gunakan installer resmi yang memenuhi versi minimum rilis; jangan mengedit journal atau menonaktifkan pemeriksaan signature.
Jangan menjalankan instalasi baru di atas direktori berisi data sebagai cara memperbaiki proses terputus. Bila ada penanda .release-initialize.pending, baca §9: migrasi parsial berbeda dari unduhan atau start layanan yang belum selesai.
3. Aplikasi hidup dan operasional venue siap
Pemeriksaan HTTPS/health membuktikan aplikasi merespons. Venue baru layak menerima pelanggan setelah pengaturan bisnis dan integrasinya diuji.
- Buka domain booking melalui HTTPS dan masuk sebagai pemilik. Verifikasi akses admin, bukan hanya tampilan halaman login.
- Pastikan cabang/lapangan contoh sudah bersih. Isi lokasi, zona waktu, lapangan, tarif, jam operasional, hari libur, tarif jam sibuk, dan layanan tambahan sesuai venue.
- Atur pajak, rekening/QRIS, batas bayar, pembatalan/refund, FAQ, referral, logo, kontak, dan merek. Tinjau konten bawaan sebelum ditampilkan kepada pelanggan.
- Hubungkan payment gateway milik venue dan cocokkan domain callback. Uji transaksi serta callback; tampilnya pilihan QRIS belum membuktikan settlement otomatis.
- Hubungkan WhatsApp melalui admin dan verifikasi status sesi serta callback. WAHA yang sehat sebagai container belum berarti nomor WhatsApp terpasangkan. Jumlah sesi harus sesuai edisi WAHA yang diuji.
- Isi bot Telegram, provider AI, email, OAuth, dan Web Push hanya jika dipakai.
EMAIL_PROVIDER=noneberarti email belum aktif. PWA/Web Push memerlukan HTTPS dan izin/perangkat yang mendukung. - Buat staf dengan cakupan cabang/izin yang tepat; uji bahwa akses ke cabang lain ditolak.
- Uji booking, pembayaran, invoice, pembatalan, voucher, chat, dan notifikasi dengan data/penerima uji yang disetujui. Catat hasil serta versi image.
Akun pemilik menggunakan email/password pada /admin/login, termasuk sebelum nomor WhatsApp dipasangkan. Halaman masuk member juga menyediakan tautan masuk pemilik/staf.
Nama PWA mengikuti APP_NAME dari nama venue di wizard, sehingga satu image frontend dapat digunakan untuk venue berbeda tanpa build ulang. Operator dapat mengatur PWA_NAME, PWA_SHORT_NAME, PWA_DESCRIPTION, PWA_THEME_COLOR, PWA_BACKGROUND_COLOR, serta path ikon PNG lokal PWA_ICON_192/PWA_ICON_512 melalui konfigurasi runtime. Ikon 192/512 piksel harus sudah tersedia di aset image; URL eksternal tidak didukung. Setelah perubahan konfigurasi diterapkan, manifest diperbarui tanpa cache dan identitas aplikasi tetap sama. Browser dapat menunda perubahan label/ikon shortcut yang sudah terpasang. Pengaturan tampilan website tetap tersedia melalui admin.
Installer membersihkan kredensial bootstrap dari konfigurasi dan journal setelah login serta kesiapan aplikasi terverifikasi. Untuk pemasangan manual lewat helper, kosongkan kedua ADMIN_EMAIL dan ADMIN_PASSWORD di .env memakai editor privat, lalu terapkan melalui helper up. Mengganti password bootstrap bukan cara mereset password akun yang sudah dibuat. Jangan mencetak .env ke terminal/log dukungan.
4. Perintah harian
Semua contoh menggunakan instalasi /opt/amanah-sport. Gunakan lokasi sebenarnya bila berbeda.
| Keperluan | Perintah |
|---|---|
| Lihat kondisi aplikasi | amanah-installer status --directory /opt/amanah-sport |
| Pemeriksaan diagnosis | amanah-installer doctor --directory /opt/amanah-sport |
| Nyalakan layanan aplikasi | amanah-installer start --directory /opt/amanah-sport |
| Hentikan layanan aplikasi | amanah-installer stop --directory /opt/amanah-sport |
| Mulai ulang layanan aplikasi | amanah-installer restart --directory /opt/amanah-sport |
| Lihat log backend | amanah-installer logs backend --directory /opt/amanah-sport |
| Ikuti log backend | amanah-installer logs backend --follow --directory /opt/amanah-sport |
| Lihat log HTTPS/proxy | amanah-installer logs proxy --directory /opt/amanah-sport |
| Buat backup | amanah-installer backup /srv/amanah-backups --directory /opt/amanah-sport |
Pilihan log: backend, frontend, postgres, proxy, atau waha. Ctrl+C menghentikan tampilan log yang diikuti, bukan mematikan container. Layanan WAHA hanya ada/berjalan jika profil messaging diaktifkan.
stop berarti downtime aplikasi; data dalam volume tetap dipertahankan. start dan restart tidak mengulang masa trial. Saat trial belum berakhir tetapi pusat lisensi tidak dapat dihubungi, proses yang di-restart tetap memerlukan verifikasi online baru; restart berulang tidak menyelesaikan gangguan lisensi.
Helper rilis masih dapat dijalankan dari direktori instalasi untuk operasi yang belum menjadi shortcut installer:
cd /opt/amanah-sport
python3 release.py validate
python3 release.py up
python3 release.py checkvalidate memeriksa konfigurasi. up menerapkan/menghidupkan layanan dan memeriksa HTTPS. check menguji domain yang dituju DNS saat itu; pastikan domain menuju VPS yang sedang ditangani. Gunakan helper untuk perubahan keadaan agar pemeriksaan konfigurasi dan lock operasi tetap berlaku.
5. Bedakan restart aplikasi, Docker, dan VPS
| Tindakan | Dampak | Kapan digunakan |
|---|---|---|
amanah-installer restart … | Memulai ulang layanan instalasi Amanah tersebut | Setelah perbaikan konfigurasi/layanan sesuai panduan |
systemctl restart docker | Memulai ulang daemon Docker; dapat mengganggu semua aplikasi Docker pada VPS | Daemon macet/gagal dan diagnosis mendukung tindakan tersebut |
reboot | Memulai ulang seluruh VPS dan memutus SSH | Pemeliharaan OS/kernel atau pemulihan host yang sudah direncanakan |
Periksa Docker sebelum memulai ulang daemon:
systemctl is-active docker
systemctl status docker --no-pager
journalctl -u docker -n 100 --no-pagerJika daemon berhenti dan penyebabnya sudah diperbaiki:
systemctl start docker
amanah-installer start --directory /opt/amanah-sportJika restart daemon memang diperlukan, lakukan pada jendela downtime, perhatikan aplikasi lain di VPS, kemudian jalankan status dan doctor Amanah. Setelah reboot, tunggu SSH kembali, periksa Docker, lalu periksa/nyalakan instalasi Amanah. Jangan berasumsi semua layanan sehat hanya karena host berhasil boot.
6. Cara menelusuri gangguan Docker
Mulai dengan status, doctor, dan log komponen yang gagal. Untuk pemeriksaan tambahan, pindah ke direktori instalasi yang tepat dan gunakan shell tanpa override COMPOSE_* yang tidak disengaja:
cd /opt/amanah-sport
docker compose ps
docker compose logs --tail 100 backend frontend proxy
docker compose logs --tail 100 postgres
docker compose logs --tail 100 waha
docker stats --no-stream
df -h
df -i
free -h
docker system dfdocker stats membantu melihat CPU/RAM; df -h memeriksa kapasitas disk, sedangkan df -i memeriksa inode. docker system df hanya melaporkan pemakaian; hasil besar tidak berarti semua data aman dihapus.
Untuk dugaan kehabisan RAM, ambil ID container backend dari docker compose ps -q backend, kemudian gunakan ID yang sebenarnya menggantikan CONTAINER_ID:
docker compose ps -q backend
docker inspect --format '{{.Name}} OOMKilled={{.State.OOMKilled}} Exit={{.State.ExitCode}} Restarts={{.RestartCount}}' CONTAINER_ID
journalctl -k -n 100 --no-pagerGunakan format inspeksi terpilih tersebut. docker inspect tanpa format dan docker compose config lengkap dapat menampilkan environment/secret; jangan menyalinnya ke tiket. Sebelum membagikan log aplikasi, hapus token, password, data pribadi, nomor pelanggan, isi chat, dan detail pembayaran yang tidak diperlukan.
Catat waktu kejadian, tindakan terakhir, versi rilis, layanan yang gagal, HTTP/error code, sisa disk/RAM, dan perubahan DNS/jaringan. Informasi itu lebih berguna daripada mencoba restart berulang tanpa mengetahui penyebabnya.
7. DNS, HTTPS, port, dan waktu server
Ganti booking.venue.example dengan hostname venue:
getent ahosts booking.venue.example
ss -lntp
curl --max-time 15 -I https://booking.venue.example/health
timedatectl statusBila dig tersedia, bandingkan record A dan AAAA. Pastikan record benar pada DNS publik, firewall/cloud security group membuka 80/443, serta tidak ada Nginx/Apache/container lain mengambil port tersebut. Periksa log proxy untuk kegagalan penerbitan sertifikat. Jangan membuka PostgreSQL atau WAHA ke internet untuk memperbaiki masalah HTTPS.
Jika VPS tidak membutuhkan IPv6 dan record AAAA masih menunjuk host lain, benahi DNS secara terencana; jangan hanya menguji IPv4 lalu menganggap semua pengunjung sudah menuju VPS yang benar. Bila memakai CDN/proxy tambahan, cocokkan mode TLS dan rantai proxy dengan konfigurasi Caddy yang diuji.
Waktu OS harus tersinkronisasi untuk TLS dan operasi server. Jika sinkronisasi mati, aktifkan kembali melalui pengelola waktu Ubuntu yang digunakan. Perubahan tanggal lokal tidak mereset trial; tanggal akhir tetap ditentukan pusat lisensi. Jangan memundurkan jam sebagai cara memperpanjang masa uji.
Uji juga dari jaringan di luar VPS, bukan hanya terminal server. Verifikasi halaman aplikasi, HTTPS, dan login melalui IPv4; bila DNS memiliki AAAA, ulangi melalui IPv6. Firewall publik yang menutup port 443 atau record AAAA yang salah dapat luput dari pemeriksaan melalui satu jalur lokal. Simpan bukti jaringan yang diuji sebelum menyatakan aplikasi dapat dipakai pelanggan.
8. Masalah lisensi dan koneksi
| Gejala | Artinya dan tindakan |
|---|---|
| Belum diaktifkan / setup | Instalasi baru direservasi; tahap setup belum selesai. Lanjutkan tahapan installer yang dinyatakan aman; jangan menerima booking nyata. |
INSTALLATION_NOT_FOUND / kredensial salah | Identitas/secret tidak cocok dengan pusat. Pastikan direktori yang digunakan benar; hubungi operator untuk pemulihan identitas, bukan membuat trial baru. |
INSTALLATION_CONFLICT | Key sudah terikat pada identitas lain. Jangan menghapus database atau mencoba mengambil alih slot secara otomatis. |
NONCE_REUSED | Request sebelumnya dipakai ulang. Klien harus membuat nonce baru pada retry; jangan menyalin token respons lama ke file konfigurasi. |
LICENSE_EXPIRED | Waktu trial berakhir. Aktifkan pembelian penuh yang sudah disahkan; restart, reinstall, restore, atau perubahan jam tidak memperpanjangnya. |
LICENSE_REVOKED | Izin dicabut pusat. Minta operator memeriksa status pesanan/lisensi. |
| Verifikasi tidak tersedia / HTTP 503 | Pusat atau koneksi keluar sedang gagal. Periksa DNS, TLS, firewall keluar, dan status pusat; bedakan dari trial kedaluwarsa. |
| HTTP 429 | Terlalu banyak request. Tunggu sesuai backoff; jangan menjalankan banyak proses resume/restart bersamaan. |
| Signature/issuer/release manifest ditolak | File, key verifikasi, domain, atau versi tidak cocok. Ambil rilis resmi yang benar; jangan mematikan verifikasi untuk melanjutkan instalasi. |
Selama trial, backend memperbarui lease secara berkala. Gangguan jaringan hanya dapat ditoleransi sampai lease yang sah berakhir, maksimum satu jam (60 menit) dan tidak pernah melewati batas trial. Proses baru harus online untuk mendapat izin baru. Lisensi penuh perpetual memiliki kebijakan terpisah; berakhirnya paket Software Care (update fitur tahunan) maupun Jasa Rawat Server Bulanan (VPS Ops) bukan pemicu penguncian aplikasi.
Jika key hilang atau respons penerbitan terputus, hubungi tim resmi Amanah melalui email support@amanahsport.cloud atau WhatsApp +62 821-2190-9056 dengan referensi pesanan/invoice. Operator dapat mencari lisensi yang sama dan merotasi key, sehingga tidak menerbitkan trial baru. Simpan key pengganti melalui saluran privat.
Jika seluruh identitas instalasi hilang, operator dapat mengikat lisensi yang sama ke identitas tujuan yang disiapkan installer. Tanggal aktivasi/akhir trial tetap dipertahankan, dan kredensial identitas lama ditolak pada verifikasi berikutnya. Hentikan sumber sebelum pindah VPS; jangan menjalankan dua salinan aktif. Lisensi yang dicabut tidak dapat dipulihkan melalui alur rotasi/rebind.
Setelah jaringan pulih, jalankan status/doctor; start atau resume hanya bila tahapnya memang memerlukan itu. Jangan mengubah license_id, key, secret, generation, expiry, atau file state secara manual. Backup lama tidak membatalkan keputusan pusat.
9. Gangguan umum dan pemulihan yang sesuai
| Masalah | Diagnosis dan langkah berikut |
|---|---|
| Docker command gagal tersambung | Periksa systemctl status docker, disk, dan journal Docker; nyalakan daemon setelah penyebabnya jelas. |
port is already allocated | Periksa ss -lntp dan container lain; pindahkan/hentikan layanan yang memang berbenturan sesuai rencana, jangan mengubah port database menjadi publik. |
| Pull image denied / unauthorized | Pastikan nama image/digest sesuai rilis resmi dan koneksi registry tersedia. Image resmi harus dapat ditarik tanpa login; laporkan rilis yang meminta kredensial kepada tim Amanah. Jangan memakai token penerbit bersama atau menonaktifkan verifikasi. |
| DNS lookup / TLS keluar gagal | Periksa resolver, waktu OS, DNS provider, proxy/firewall keluar, dan koneksi internet. Menonaktifkan verifikasi TLS bukan perbaikan. |
| Disk penuh / inode habis | Identifikasi pemakaian log/image/media/backup. Pindahkan backup lama sesuai retensi yang disetujui atau tambah disk; pertahankan volume dan recovery point yang diperlukan. |
| Container terus restart / OOM | Periksa log, flag OOM, RAM, dan ukuran beban. Sesuaikan kapasitas/konfigurasi; jangan menganggap restart loop selesai karena container sempat hidup. |
| Login bootstrap gagal | Periksa apakah admin pernah dibuat; bootstrap env hanya untuk pembuatan awal. Gunakan pemulihan akun yang didukung, bukan reset database. |
| WhatsApp tidak menerima/mengirim | Periksa profil messaging, kesehatan WAHA, status pairing nomor, sesi aktif, callback, dan edisi provider. Container sehat saja belum membuktikan pairing. |
| Pembayaran tidak diperbarui | Periksa kredensial/mode gateway, domain callback, log backend, dan status transaksi provider. Jangan menyetujui ulang secara manual sebelum memeriksa duplikasi/status asli. |
.release-operation.lock | Lock aktif berarti operasi lain masih berjalan. Tunggu dan periksa aktivitas Docker. Berkas lock tetap boleh ada setelah proses selesai; kunci sistem dilepas otomatis saat proses berhenti. Jangan menghapus berkas untuk melewati operasi aktif. |
.release-initialize.pending | Inisialisasi/migrasi belum selesai; helper menolak operasi berikutnya. Simpan keadaan untuk diagnosis dan gunakan direktori/proyek baru yang kosong sesuai instruksi operator. Jangan menghapus penanda untuk memaksa DB parsial online. |
.release-restore.pending | Restore sebelumnya gagal setelah penulisan dimulai. Start diblokir; simpan bukti kegagalan dan gunakan target baru yang kosong, jangan hapus marker untuk memaksa start. |
| Restore ditolak karena target terisi | Penolakan disengaja. Gunakan target dengan direktori, nama Compose, database, dan volume baru; jangan membersihkan data lama secara spontan. |
Jangan menjalankan docker compose down -v, docker system prune --volumes, atau reset database sebagai langkah diagnosis umum. Tindakan itu dapat menghilangkan data atau bahan pemulihan yang masih diperlukan.
10. Backup rutin
amanah-installer backup /srv/amanah-backups --directory /opt/amanah-sport
cd /opt/amanah-sport
python3 release.py verify-backup /srv/amanah-backups/TIMESTAMP-IDGanti TIMESTAMP-ID dengan lokasi backup lengkap yang dicetak helper. Backup menghentikan layanan penulis sementara (termasuk backend/worker dan WAHA), membuat dump database serta arsip media, lalu menyalakan kembali layanan yang sebelumnya berjalan setelah selesai/kegagalan yang tertangani. Ada downtime. Bila VPS mati mendadak, operator harus memeriksa keadaan sebelum menyalakan aplikasi kembali.
Backup lengkap mencakup database, uploads, sesi WhatsApp, .env, Compose/Caddy, metadata, serta checksum. Backup format 2 juga menyertakan license.json bila identitas lisensi tersebut ada pada instalasi. Format 3 menambahkan journal installer yang selesai dan arsip rilis terverifikasi untuk pemulihan serta upgrade berikutnya. Arsip media juga mencakup volume cache lisensi (licensing); trial tetap membutuhkan verifikasi online pada startup, sedangkan cache perpetual yang sah dapat digunakan sesuai kebijakan lisensi. Direktori .partial bukan recovery point. Sertifikat Caddy tidak termasuk dan akan diterbitkan kembali. Simpan juga paket rilis dan akses pull image. Backup lama format 1 yang tidak memuat identitas membutuhkan prosedur pemulihan identitas terpisah.
Helper belum mengenkripsi backup. Lindungi media/tujuan dengan enkripsi, batasi akses operator, dan simpan salinan di luar host. Database, konfigurasi, bukti pembayaran, dan sesi WhatsApp bersifat sensitif. Tetapkan frekuensi, retensi, alarm kegagalan, dan penerima alarm; pembuatan backup manual tidak memasang jadwal otomatis.
Lakukan uji restore berkala. Memiliki folder backup saja belum membuktikan data dapat dipulihkan. Catat kapan backup selesai, hasil verifikasi, lokasi salinan di luar host, dan hasil latihan restore.
11. Restore, pindah VPS, dan rollback
Restore harus menuju direktori dan Compose project baru dengan database serta volume kosong. Pertahankan sumber sampai target diterima. Jangan jalankan initialize pada target restore atau dua salinan aktif yang menggunakan sesi messaging/provider yang sama.
- Verifikasi backup lengkap dari sumber tepercaya. Siapkan prasyarat VPS tujuan serta installer resmi, berkas rilis, dan referensi image. Isolasi koneksi provider saat simulasi agar salinan tidak mengirim pesan atau memproses pembayaran sungguhan.
- Pulihkan ke lokasi baru. Installer menyiapkan konfigurasi target dan nama Compose project baru:
amanah-installer restore /srv/amanah-backups/TIMESTAMP-ID \
--directory /opt/amanah-restore- Restore menyalakan PostgreSQL dan memulihkan data/media; layanan aplikasi tetap berhenti. Target berisi data akan ditolak. Jika restore gagal setelah data target ditulis, simpan target tersebut untuk diagnosis dan gunakan target kosong lain untuk percobaan berikutnya.
- Backup format 2/3 memulihkan
license.json. Periksa ownershiproot:10001dan mode0640sesuai petunjuk helper tanpa menampilkan isinya. Trial tetap memakai periode awal dan startup memverifikasi secara online. Format 3 juga menyimpan journal installer dan arsip rilis yang terautentikasi. Bila identitas tidak cocok atau backup lama tidak memilikinya, selesaikan recovery dengan operator sebelum membuka trafik. - Pastikan hanya satu instalasi memakai domain/port publik dan sesi provider. Hentikan sumber sebelum mengalihkan trafik ke target. Tinjau
.envtarget melalui editor privat jika domain atau callback provider harus diubah; jangan menyalin nilainya ke log dukungan. - Nyalakan dan periksa instalasi hasil pemulihan:
amanah-installer start --directory /opt/amanah-restore
amanah-installer doctor --directory /opt/amanah-restore- Uji HTTPS, login pemilik, riwayat booking/pembayaran, konfigurasi, sampel/checksum media, invoice, dan integrasi aktif, termasuk dari luar VPS. Rekonsiliasi transaksi sejak snapshot sebelum membuka booking kembali.
Untuk instalasi lama yang dikelola langsung dengan helper rilis resmi, python3 release.py restore BACKUP_PATH dan alias rollback memulihkan ke target kosong yang sudah disiapkan. Ikuti prosedur rilis terverifikasi yang sesuai versi helper tersebut. Menurunkan versi image pada database yang sudah dimigrasikan bukan rollback yang aman. Backup lama dapat kehilangan perubahan sesudah snapshot; perhitungkan rentang transaksi tersebut.
12. Upgrade versi aplikasi
Upgrade aplikasi berbeda dari pembelian lisensi atau penambahan kapasitas cabang. Pembaruan fitur baru setelah tahun pertama tersedia bagi pemegang paket aktif Software Care (opsional tahunan, terpisah dari Jasa Rawat Server Bulanan / VPS Ops). Untuk instalasi yang diselesaikan oleh installer, gunakan:
amanah-installer upgrade --directory /opt/amanah-sport \
--backup-directory /srv/amanah-backupsInstaller mengambil manifest resmi terbaru yang ditandatangani dan memverifikasi paket, versi, serta pasangan digest backend/frontend yang kompatibel. Identitas instalasi diperiksa, login pemilik dan konfirmasi diminta, kemudian backup konsisten dibuat sebelum image diterapkan. Sediakan jadwal downtime. Jika rilis yang sama sudah terpasang, upgrade tidak diperlukan. Selesaikan instalasi terputus dengan resume sebelum upgrade.
Pemeriksaan penerimaan mencakup HTTPS, login pemilik, lisensi, identitas instalasi, dan versi rilis yang diharapkan. Jika verifikasi gagal setelah perubahan, layanan dihentikan dan lokasi backup pemulihan ditampilkan. Restore ke target baru yang kosong; jangan menurunkan versi database aktif yang sudah dimigrasikan. Ulangi alur bisnis yang terdampak setelah pemeriksaan otomatis lulus.
Shortcut ini mendukung pembaruan image aplikasi yang kompatibel. Perubahan helper rilis, Compose/Caddy, infrastruktur, kontrak backup, atau versi mayor PostgreSQL memerlukan prosedur migrasi rilis tersendiri. Perubahan lokal pada berkas rilis yang dilindungi juga perlu ditinjau. Jangan mengganti PostgreSQL 17 dengan versi mayor lain melalui edit tag biasa.
Untuk instalasi lama tanpa journal installer, prosedur operator resmi dapat memakai helper dengan pasangan backend/frontend yang disediakan dan diuji bersama:
cd /opt/amanah-sport
python3 release.py upgrade \
--backend-image ghcr.io/amanah-sport/backend@sha256:DIGEST_BACKEND \
--frontend-image ghcr.io/amanah-sport/frontend@sha256:DIGEST_FRONTEND \
--backup-directory /srv/amanah-backupsGanti placeholder dengan referensi image resmi serta digest SHA-256 lengkap sepanjang 64 karakter. Helper hanya mengganti image aplikasi; perintah ini tidak menjadi izin perubahan infrastruktur lain atau melewati prosedur migrasi rilis.
13. Catatan penerimaan dan bukti verifikasi
Simpan versi installer, versi rilis, digest image, domain, waktu aktivasi/akhir trial, hasil pemeriksaan, serta lokasi backup secara privat. Catat masalah yang tersisa dan pihak yang menanganinya.
Pemeriksaan lokal tidak menggantikan penerimaan di VPS pelanggan. DNS publik, installer di Ubuntu, registry, HTTPS, pairing WhatsApp, pembayaran gateway, dan pemulihan perlu dibuktikan pada lingkungan venue. Gunakan laporan validasi yang disertakan dengan rilis; jangan menyatakan server siap hanya karena satu pemeriksaan berhasil.
Sebelum membuka penggunaan pelanggan, bukti yang masih harus dicatat pada VPS nyata meliputi: installer satu berkas berjalan dari awal, restart/reboot berhasil pulih, domain/HTTPS benar, admin/staf bisa memakai fitur sesuai haknya, expiry/aktivasi kembali bekerja, pembayaran dan pesan teruji, serta satu latihan backup-restore berhasil. Gunakan hasil nyata tersebut untuk menyatakan instalasi diterima.
Dukungan Teknis Resmi & Tautan Legal
Penyerahan installer resmi, license key, rotasi key, dan bantuan resmi Amanah Sport hanya melalui kontak terverifikasi di bawah ini.