Konfigurasi lanjutan

Databasus bisa langsung berjalan dengan pengaturan default yang sesuai. Instalasi standar dengan satu container tidak membutuhkan konfigurasi apa pun. Semua variabel di halaman ini opsional dan tidak diperlukan pada 99% konfigurasi production

OAuth

Secara default, Databasus menggunakan email dan password untuk login. Kamu juga bisa mengizinkan pengguna login dengan akun Google atau GitHub. Tombol penyedia muncul begitu client ID diisi, tetapi login baru bisa diselesaikan jika keduanya, client ID dan client secret, sudah tersedia.

Saat mendaftarkan aplikasi OAuth, atur URL redirect (callback) ke https://<your-domain>/auth/callback. Karena redirect ini, login OAuth membutuhkan instance yang bisa diakses melalui HTTPS pada domain publik. Lihat catatan berikut.

Google

Buat client OAuth di Google Cloud Console (APIs & Services → Credentials → Create credentials → OAuth client ID, jenis aplikasi Web application), lalu tambahkan https://<your-domain>/auth/callback sebagai authorized redirect URI.

GitHub

Buat aplikasi OAuth di GitHub Developer settings (Settings → Developer settings → OAuth Apps → New OAuth App), lalu atur authorization callback URL ke https://<your-domain>/auth/callback.

Email (SMTP)

Hubungkan mail server agar Databasus bisa mengirim undangan ruang kerja, kode reset password, dan kode login. Mail server dianggap sudah dikonfigurasi begitu SMTP_HOST diisi. Tanpa variabel ini, layar pengaturan melaporkan mail server belum dikonfigurasi, dan layar login menyembunyikan tautan reset password.

Ini adalah mail server untuk instance. Kanal notifikasi email yang melaporkan peristiwa backup memiliki pengaturan SMTP sendiri pada formulir masing-masing. Jadi, keberhasilan kanal notifikasi mengirim email tidak menunjukkan bahwa server ini berfungsi. Untuk memeriksa mail server instance, buka Databasus settings → Mail server, lalu tekan Send test email. Pesan dikirim ke alamat kamu sendiri, dan jika gagal, respons mail server akan ditampilkan.

SMTP_SECURITY memilih satu dari tiga mode. Kanal notifikasi email menyediakan pilihan yang sama di Advanced settings.

Captcha pendaftaran (Cloudflare Turnstile)

Jika instance kamu bisa diakses dari internet publik, kamu bisa memasang tantangan Cloudflare Turnstile pada formulir pendaftaran dan login untuk menghalau bot. Kedua key berasal dari dashboard Turnstile, dan tantangan hanya aktif jika keduanya diisi.

Izin penyimpanan Docker

Biasanya Databasus memilih ID numerik pengguna dan grup dari direktori pgdata yang sudah ada, lalu dari mount backup atau direktori root data, dan terakhir menggunakan 999. Atur PUID atau PGID hanya jika pilihan otomatis ini tidak sesuai dengan bind mount, CIFS share, atau NFS export kamu. Nilai harus berupa bilangan bulat basis 10 dari 1 sampai 4294967294.

Databasus dan PostgreSQL menggunakan akun sistem operasi non-root yang sama bernama databasus.

Entrypoint dimulai sebagai root di dalam container untuk memilih ID dan mencoba chown serta chmod. Setelah itu, siklus hidup file yang sebenarnya diperiksa sebagai databasus. Mount tetap bisa berfungsi meskipun menolak perubahan metadata. Override Docker user: sembarangan tidak didukung.

ERROR: Databasus cannot write to local storage paths /databasus-data/temp and /databasus-data/backups as UID 999 and GID 999.
Required operation: save a file through local storage.
Set PUID and PGID or fix the mounted directory permissions: https://databasus.com/advanced-config/#docker-storage-permissions
Details: permission denied

Empat variabel identitas khusus layanan sebelumnya sengaja dihapus. Hapus variabel tersebut dari konfigurasi saat upgrade. Jika ID otomatis tidak bisa mengakses mount, startup berhenti dengan informasi operasi yang gagal dan tautan dokumentasi ini.

Telemetri

Secara default, Databasus mengirim telemetri penggunaan anonim yang tidak mengidentifikasi pengguna. Telemetri tidak berisi data pribadi dan membantu kami memahami penggunaan proyek. Rincian data yang dikumpulkan tersedia di kebijakan privasi, dan kamu bisa menonaktifkannya sepenuhnya.

Logging

Databasus menulis log ke stdout dan menyalinnya sebagai JSON ke databasus.log pada volume data. Atur OPEN_TELEMETRY_URL agar log juga diekspor melalui Open Telemetry ke backend seperti VictoriaLogs, Graylog, SigNoz, Grafana Loki, Datadog, atau Honeycomb, maupun ke OpenTelemetry Collector yang juga merupakan penerima OTLP.

• Transport mengikuti skema. http:// dan https:// mengirim OTLP/HTTP dan menggunakan URL apa adanya, termasuk path; grpc:// dan grpcs:// mengirim OTLP/gRPC dan hanya menggunakan host serta port.
• Autentikasi dimasukkan ke OPEN_TELEMETRY_HEADERS atau ke URL sebagai user:password@host.
• Secret (password, token, kredensial) di dalam URL disamarkan sebelum catatan keluar dari proses.
• Catatan audit dikirim bersama log aplikasi dengan tag log_type=audit dan mengabaikan LOG_LEVEL, sehingga menaikkan level tidak pernah menghilangkan jejak audit.

Nilai untuk backend umum, masing-masing beserta header autentikasinya. Ganti host, region, dan key dengan milik kamu sendiri:

Nilai header di-percent-decode, sehingga spasi setelah Basic atau Bearer ditulis sebagai %20 dan koma di dalam nilai sebagai %2C. Basic auth juga bisa langsung dimasukkan ke URL sebagai https://user:password@host/path. Databasus mengubahnya menjadi header yang sama dan menyembunyikannya dari log. Melalui http:// dan grpc://, key dan password dikirim tanpa enkripsi, jadi gunakan https:// atau grpcs:// di luar jaringan tepercaya.

Script analitik

Databasus bisa menyisipkan snippet analitik atau pelacakan kamu sendiri, seperti Google Analytics, Plausible, Umami, dan sejenisnya, ke aplikasi. Jika ANALYTICS_SCRIPT diisi, nilainya disisipkan ke <head> halaman saat startup.

Peringatan keamanan: nilai ini disisipkan apa adanya sebagai HTML dan JavaScript mentah, lalu berjalan dengan akses penuh ke antarmuka Databasus di browser setiap pengunjung. Hanya isi dengan snippet yang sepenuhnya kamu kendalikan dan percayai.