DocsStack & database

Template one-click

Katalog aplikasi siap pakai yang dijalankan sebagai stack compose dalam beberapa klik.

Katalog: 6 template, dibundel di dalam aoox
Hasil: Stack compose (source: template)
Rahasia: Password/secret di-generate otomatis

Katalog

Template	Versi	Untuk apa	Harus diisi	Service (port)
`wordpress`	6.8	CMS/blog + MySQL	—	wordpress :80
`ghost`	5	Platform publishing	URL publik	ghost :2368
`n8n`	1.x	Automasi workflow	Host publik; protokol & zona waktu punya default	n8n :5678
`uptime-kuma`	1	Monitoring uptime	—	uptime-kuma :3001
`minio`	latest	Object storage S3 — bisa jadi tujuan backup	Root user punya default	Console :9001 · API S3 :9000
`gitea`	1.24	Git hosting ringan	URL publik	gitea :3000

Katalog ditulis di dalam kode aoox — tidak diambil dari internet saat runtime, jadi tetap jalan offline dan isinya tidak bisa diganti pihak lain. Semua password, secret, dan key di-generate otomatis (alfanumerik) bila dikosongkan.

Men-deploy template

Menu Templates → pilih template
Atau dari halaman project klik Dari template agar project sudah terpilih. Ada kotak pencarian untuk katalog.

Isi dialog deploy

Bagian	Keterangan
Project & Nama	Nama jadi slug stack; project compose = aoox-<slug>.
Hostname per service + HTTPS	Satu baris per service yang bisa diekspos (mis. MinIO punya dua: Console dan API). Kosongkan bila tidak ingin domain.
Port host per service	Alternatif tanpa domain: stack langsung bisa dibuka lewat `<ip-server>:<port>`. Bentrokan port ditolak saat menyimpan — lihat Akses stack.
Variabel	Field dengan label dan hint dari template. Yang bertanda wajib harus diisi (mis. URL publik untuk Ghost/Gitea, Host publik untuk n8n). Sisanya: kosong = default / di-generate.

URL publik harus sama dengan domain

Ghost, Gitea, dan n8n memakai URL/host publik untuk membangun tautan dan webhook-nya sendiri. Isi persis sesuai hostname yang kamu pasang, termasuk skema (https://blog.example.com) — kalau berbeda, halaman admin/tautan akan salah arah.

Deploy
Kamu diarahkan ke halaman stack compose yang baru. Deploy berjalan di latar (pull image bisa beberapa menit); pantau Log aksi terakhir sampai status running.
Verifikasi
Buka hostname yang dipasang. Untuk kredensial admin awal (mis. MinIO root password, DB password) lihat env stack di tab Pengaturan — nilai yang di-generate tersimpan di sana.

Contoh: WordPress dengan domain

Dialog deploy

Project     : toko
Nama        : blog
Service     : wordpress → blog.example.com  [HTTPS ✓]
Variabel    : DB_PASSWORD (kosong → di-generate)
              DB_ROOT_PASSWORD (kosong → di-generate)

Setelah running, buka https://blog.example.com dan selesaikan wizard WordPress. Database MySQL ada di dalam stack (bukan managed database) — backup-nya jadi tanggung jawab plugin/skrip kamu, atau pindahkan ke managed database dengan mengedit compose.

Setelah deploy

File compose tersimpan di aoox dan bisa diedit di tab Pengaturan stack (textarea), lalu deploy ulang — mis. menambah service, mengubah image tag, atau menunjuk managed database.
Env stack berisi nilai variabel (termasuk yang di-generate); ubah lalu deploy ulang bila perlu.
Domain per service bisa ditambah/diubah lewat kartu Domain; saran service diambil dari katalog.
Stop / Start / Hapus sama seperti stack compose lain — Hapus menghapus volume data.

Jebakan umum

Gejala	Penyebab & solusi
400: variabel wajib kosong	URL/Host publik belum diisi (Ghost, Gitea, n8n).
Tautan admin mengarah ke localhost / http	URL publik tidak sama dengan domain, atau protokol n8n masih http. Perbaiki env stack, deploy ulang.
Deploy lama di deploying	Pull image pertama kali. Tunggu; cek Log aksi terakhir untuk progres.
MinIO tidak bisa dipakai sebagai tujuan backup	Pasang domain/hostname untuk service API S3 (port 9000), atau pakai endpoint internal `http://<container>:9000` — stack harus di network `aoox`.

Belum tersedia

Template dari repo/URL kustom; upgrade versi template yang sudah di-deploy; ikon template saat offline. Batasan stack compose lainnya berlaku — lihat Stack compose.

Langkah berikutnya

Stack composeOperasi, env, dan batasan yang juga berlaku untuk template.Proxy & domainTraefik + DNS untuk hostname yang diisi.Backup & restorePakai MinIO dari template sebagai tujuan S3.ProjectTempat stack template tinggal.

Ada yang keliru? Edit halaman ini di GitLab ↗