Lewati ke konten utama

Pusat dokumentasi

Instalasi dan operasional.

Panduan memasang Amanah Sport, mengelola layanan, dan memulihkan data di VPS venue Anda.

Diperbarui 19 November 2026 Ubuntu 24.04 amd64 Created by Amanah Karya Perdana

Simpan panduan (.md)

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:

Terminal
sha256sum /root/amanah-installer

Setelah checksum cocok, pasang executable pada lokasi yang mudah dipakai ulang:

Terminal
install -m 0755 /root/amanah-installer /usr/local/bin/amanah-installer
amanah-installer install --directory /opt/amanah-sport

Ikuti 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:

PilihanDiisi saat instalasiOnboarding yang masih perlu dilakukan
WhatsAppAktifkan layanan messaging lokalPasangkan nomor di admin dan uji kirim/terima
Login GoogleOAuth client ID dan secretDaftarkan origin dan https://booking.venue.example/api/auth/google/callback di Google, lalu uji login
TelegramBot ID angka untuk login, opsionalHubungkan bot/sesi melalui admin dan izinkan domain login pada provider
PembayaranManual, Midtrans, atau XenditIsi kredensial dan mode sandbox/produksi pada pengaturan cabang; uji transaksi serta callback
EmailNone, SMTP, Resend, atau SendGrid; pengirim terverifikasi dan kredensial yang sesuaiVerifikasi 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:

Terminal
amanah-installer resume --directory /opt/amanah-sport

Jika 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.

  1. Buka domain booking melalui HTTPS dan masuk sebagai pemilik. Verifikasi akses admin, bukan hanya tampilan halaman login.
  2. Pastikan cabang/lapangan contoh sudah bersih. Isi lokasi, zona waktu, lapangan, tarif, jam operasional, hari libur, tarif jam sibuk, dan layanan tambahan sesuai venue.
  3. Atur pajak, rekening/QRIS, batas bayar, pembatalan/refund, FAQ, referral, logo, kontak, dan merek. Tinjau konten bawaan sebelum ditampilkan kepada pelanggan.
  4. Hubungkan payment gateway milik venue dan cocokkan domain callback. Uji transaksi serta callback; tampilnya pilihan QRIS belum membuktikan settlement otomatis.
  5. 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.
  6. Isi bot Telegram, provider AI, email, OAuth, dan Web Push hanya jika dipakai. EMAIL_PROVIDER=none berarti email belum aktif. PWA/Web Push memerlukan HTTPS dan izin/perangkat yang mendukung.
  7. Buat staf dengan cakupan cabang/izin yang tepat; uji bahwa akses ke cabang lain ditolak.
  8. 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.

KeperluanPerintah
Lihat kondisi aplikasiamanah-installer status --directory /opt/amanah-sport
Pemeriksaan diagnosisamanah-installer doctor --directory /opt/amanah-sport
Nyalakan layanan aplikasiamanah-installer start --directory /opt/amanah-sport
Hentikan layanan aplikasiamanah-installer stop --directory /opt/amanah-sport
Mulai ulang layanan aplikasiamanah-installer restart --directory /opt/amanah-sport
Lihat log backendamanah-installer logs backend --directory /opt/amanah-sport
Ikuti log backendamanah-installer logs backend --follow --directory /opt/amanah-sport
Lihat log HTTPS/proxyamanah-installer logs proxy --directory /opt/amanah-sport
Buat backupamanah-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:

Terminal
cd /opt/amanah-sport
python3 release.py validate
python3 release.py up
python3 release.py check

validate 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

TindakanDampakKapan digunakan
amanah-installer restart …Memulai ulang layanan instalasi Amanah tersebutSetelah perbaikan konfigurasi/layanan sesuai panduan
systemctl restart dockerMemulai ulang daemon Docker; dapat mengganggu semua aplikasi Docker pada VPSDaemon macet/gagal dan diagnosis mendukung tindakan tersebut
rebootMemulai ulang seluruh VPS dan memutus SSHPemeliharaan OS/kernel atau pemulihan host yang sudah direncanakan

Periksa Docker sebelum memulai ulang daemon:

Terminal
systemctl is-active docker
systemctl status docker --no-pager
journalctl -u docker -n 100 --no-pager

Jika daemon berhenti dan penyebabnya sudah diperbaiki:

Terminal
systemctl start docker
amanah-installer start --directory /opt/amanah-sport

Jika 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:

Terminal
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 df

docker 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:

Terminal
docker compose ps -q backend
docker inspect --format '{{.Name}} OOMKilled={{.State.OOMKilled}} Exit={{.State.ExitCode}} Restarts={{.RestartCount}}' CONTAINER_ID
journalctl -k -n 100 --no-pager

Gunakan 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:

Terminal
getent ahosts booking.venue.example
ss -lntp
curl --max-time 15 -I https://booking.venue.example/health
timedatectl status

Bila 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

GejalaArtinya dan tindakan
Belum diaktifkan / setupInstalasi baru direservasi; tahap setup belum selesai. Lanjutkan tahapan installer yang dinyatakan aman; jangan menerima booking nyata.
INSTALLATION_NOT_FOUND / kredensial salahIdentitas/secret tidak cocok dengan pusat. Pastikan direktori yang digunakan benar; hubungi operator untuk pemulihan identitas, bukan membuat trial baru.
INSTALLATION_CONFLICTKey sudah terikat pada identitas lain. Jangan menghapus database atau mencoba mengambil alih slot secara otomatis.
NONCE_REUSEDRequest sebelumnya dipakai ulang. Klien harus membuat nonce baru pada retry; jangan menyalin token respons lama ke file konfigurasi.
LICENSE_EXPIREDWaktu trial berakhir. Aktifkan pembelian penuh yang sudah disahkan; restart, reinstall, restore, atau perubahan jam tidak memperpanjangnya.
LICENSE_REVOKEDIzin dicabut pusat. Minta operator memeriksa status pesanan/lisensi.
Verifikasi tidak tersedia / HTTP 503Pusat atau koneksi keluar sedang gagal. Periksa DNS, TLS, firewall keluar, dan status pusat; bedakan dari trial kedaluwarsa.
HTTP 429Terlalu banyak request. Tunggu sesuai backoff; jangan menjalankan banyak proses resume/restart bersamaan.
Signature/issuer/release manifest ditolakFile, 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

MasalahDiagnosis dan langkah berikut
Docker command gagal tersambungPeriksa systemctl status docker, disk, dan journal Docker; nyalakan daemon setelah penyebabnya jelas.
port is already allocatedPeriksa ss -lntp dan container lain; pindahkan/hentikan layanan yang memang berbenturan sesuai rencana, jangan mengubah port database menjadi publik.
Pull image denied / unauthorizedPastikan 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 gagalPeriksa resolver, waktu OS, DNS provider, proxy/firewall keluar, dan koneksi internet. Menonaktifkan verifikasi TLS bukan perbaikan.
Disk penuh / inode habisIdentifikasi 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 / OOMPeriksa log, flag OOM, RAM, dan ukuran beban. Sesuaikan kapasitas/konfigurasi; jangan menganggap restart loop selesai karena container sempat hidup.
Login bootstrap gagalPeriksa apakah admin pernah dibuat; bootstrap env hanya untuk pembuatan awal. Gunakan pemulihan akun yang didukung, bukan reset database.
WhatsApp tidak menerima/mengirimPeriksa profil messaging, kesehatan WAHA, status pairing nomor, sesi aktif, callback, dan edisi provider. Container sehat saja belum membuktikan pairing.
Pembayaran tidak diperbaruiPeriksa kredensial/mode gateway, domain callback, log backend, dan status transaksi provider. Jangan menyetujui ulang secara manual sebelum memeriksa duplikasi/status asli.
.release-operation.lockLock 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.pendingInisialisasi/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.pendingRestore 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 terisiPenolakan 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

Terminal
amanah-installer backup /srv/amanah-backups --directory /opt/amanah-sport
cd /opt/amanah-sport
python3 release.py verify-backup /srv/amanah-backups/TIMESTAMP-ID

Ganti 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.

  1. 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.
  2. Pulihkan ke lokasi baru. Installer menyiapkan konfigurasi target dan nama Compose project baru:
Terminal
amanah-installer restore /srv/amanah-backups/TIMESTAMP-ID \
  --directory /opt/amanah-restore
  1. 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.
  2. Backup format 2/3 memulihkan license.json. Periksa ownership root:10001 dan mode 0640 sesuai 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.
  3. Pastikan hanya satu instalasi memakai domain/port publik dan sesi provider. Hentikan sumber sebelum mengalihkan trafik ke target. Tinjau .env target melalui editor privat jika domain atau callback provider harus diubah; jangan menyalin nilainya ke log dukungan.
  4. Nyalakan dan periksa instalasi hasil pemulihan:
Terminal
amanah-installer start --directory /opt/amanah-restore
amanah-installer doctor --directory /opt/amanah-restore
  1. 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:

Terminal
amanah-installer upgrade --directory /opt/amanah-sport \
  --backup-directory /srv/amanah-backups

Installer 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:

Terminal
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-backups

Ganti 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.

Kembali ke atas ↑