Managed database

Engine

PostgreSQL · MySQL · MariaDB · Redis · Valkey · MongoDB

Bentuk

Container + volume per database

Hubungkan

${{database.<slug>.url}} di env aplikasi

Engine yang didukung

Container mengikuti env resmi image Docker Hub (POSTGRES_*, MYSQL_*, MARIADB_*, --requirepass). Username SQL selalu app; nama database = slug dengan - diganti _. Password acak, disimpan terenkripsi.

Varian PostgreSQL

Saat membuat database dengan Engine PostgreSQL, pilih Varian untuk image dengan ekstensi sudah terpasang — protokol, kredensial, backup, dan referensi env tetap sama seperti PostgreSQL polos (hanya image dan tag default yang beda). Ekstensinya diaktifkan otomatis (CREATE EXTENSION IF NOT EXISTS) begitu container siap menerima koneksi.

• Tanpa varian (default) = image postgres polos, tanpa ekstensi tambahan.
• Ganti varian setelah dibuat tidak didukung dari dashboard — hapus lalu buat ulang (opsional: pulihkan dari backup ke database baru).
• PostGIS dan TimescaleDB sudah mengaktifkan ekstensinya sendiri saat image pertama kali start; aoox tetap memanggil CREATE EXTENSION IF NOT EXISTS sebagai jaring pengaman (aman diulang, tidak menimbulkan error).

Membuat database

1. Halaman project → Database baru

   Field	Keterangan
   Nama	Jadi slug unik (global, bukan per project). Container aoox-db-<slug>, volume aoox_db_<slug>.
   Engine	Pilih salah satu kartu: PostgreSQL / MySQL / MariaDB / Redis / Valkey / MongoDB. Untuk PostgreSQL, pilih juga Varian (opsional): Polos / pgvector / PostGIS / TimescaleDB.
   Versi (tag image)	Tag Docker Hub. Kosong = default untuk engine dan varian yang dipilih (tampil di bawah kolom dan di tabel atas). Contoh: 17, 8.4, 7.2.
   Port host	Opsional. Isi hanya kalau perlu koneksi dari luar Docker (laptop, server remote). Aplikasi di host aoox tidak membutuhkannya.
   Mendengarkan di	Default Hanya server ini (127.0.0.1): database tidak bisa dijangkau dari internet dan kamu terhubung lewat SSH tunnel (ssh -L 5432:127.0.0.1:5432 user@server). Pilih Publik hanya bila harus bisa dijangkau dari mesin lain, dan tutup untuk yang lain di firewall provider: port yang dipublikasikan Docker tidak disaring ufw. Dipilih saat membuat dan tidak bisa diubah nanti (buat ulang database).
   Batas CPU / memori	Opsional; bisa diubah nanti.

2. Tunggu status running

   1. 01creatingpull image, buat volume & container, lalu tunggu sampai engine menerima login (maksimal 2 menit; mengubah mount, batas resource, atau backup dijawab "masih memulai" selama itu)
   2. 02runningsiap dipakai; kredensial tersedia
   3. 03stoppedcontainer berhenti, data tetap
   4. 04errorprovisioning gagal — lihat pesan

   Provisioning berjalan di latar (pull image bisa lama); halaman menyegarkan otomatis selama creating.

3. Hubungkan ke aplikasi

   Di env aplikasi (project yang sama), rujuk dengan referensi — bukan menyalin password:

   Env aplikasi

   DATABASE_URL=${{database.app-db.url}}

   Deploy (atau rollback) agar container aplikasi baru mendapat nilainya. Bentuk lain (host, port, username, …) ada di Environment variables.

Koneksi

Tab Ringkasan menampilkan keduanya beserta kredensial (disamarkan, bisa disalin) dan DATABASE_URL siap tempel. Viewer project melihat host, port, database, dan user tetapi tidak pernah password maupun URL-nya, dan tab Data menampilkan nama tabel dan kolom tanpa barisnya (Redis dan Valkey: tidak ada, key adalah data).

Database tambahan di server yang sama

Satu container PostgreSQL/MySQL/MariaDB/MongoDB bisa menampung beberapa database. Di tab Ringkasan, dekat pemilih Koneksi untuk database, owner/admin bisa menekan Tambah database untuk membuat database baru dengan nama [A-Za-z_][A-Za-z0-9_]*, dan menghapus database tambahan lewat ikon tempat sampah di sebelah pemilih (ada dialog konfirmasi; seluruh isinya hilang permanen). Yang dibuat saat provisioning adalah primary dan tidak bisa dihapus. Tab Data tetap punya pemilih database untuk menjelajah.

REPORTS_DB_URL=${{database.app-db.url:reports}}

• Host, user, dan password sama — hanya bagian nama database yang berbeda.
• Tab Ringkasan menampilkan Koneksi untuk database per nama bila ada lebih dari satu. Tombol tambah/hapus hanya tampil saat database berjalan.
• Backup punya opsi menyertakan semua database di server (lihat Backup).
• Redis/Valkey tidak punya fitur ini (pakai nomor DB di URL bila perlu).
• MongoDB: database baru dibuat langsung terisi dokumen placeholder, sama seperti database utama.

Operasi

Tab lain

• Data → Data browser: tabel, query, database tambahan.
• Backup → Backup & restore: manual, jadwal, retensi, S3.
• Jobs → perintah terjadwal di container database atau container terpisah dari image engine dengan env DB_* — Scheduled jobs.
• Mount → file konfigurasi engine (my.cnf, redis.conf) atau volume tambahan — Mount.
• Metrik CPU/RAM (sampel 15 detik) di bagian atas panel.

Jebakan umum

Langkah berikutnya