Konfigurasi (variabel lingkungan)

Semua konfigurasi Celestian berasal dari variabel lingkungan (berkas deploy/.env). Tidak ada port atau URL yang ditulis di dalam kode. PUBLIC_BASE_URL adalah satu-satunya sumber URL publik.

Alamat dan web

Variabel	Bawaan	Keterangan
`PUBLIC_BASE_URL`		URL publik persis seperti yang dibuka pengguna (`https://host`, port bila bukan 443).
`WEB_BIND`, `WEB_PORT`	`127.0.0.1`, `3100`	Alamat dan port HTTP web untuk reverse proxy.
`DATA_DIR`	`./data`	Folder host untuk semua data persisten. Dibuat dan diberi pemilik oleh `data-init`.
`TZ`	`Asia/Jakarta`	Zona waktu kontainer.
`LOG_LEVEL`	`info`	Tingkat log.

Secret

Variabel	Keterangan
`PG_PASSWORD`, `TSDB_PASSWORD`, `APP_DB_PASSWORD`, `REDIS_PASSWORD`	Password layanan data. Dibuat `gen-secrets.sh`.
`JWT_PRIVATE_KEY`, `SESSION_SECRET`	Penandatanganan token dan sesi.
`BROKER_SERVICE_SECRET`	Password principal layanan internal di broker (callout dan konsumen presence). Jangan dibagikan.
`SECRETS_KEY`	Enkripsi kredensial tersimpan dan alamat unduhan firmware. Jangan diganti atau hilang; cadangkan di luar server.

Akun dan akses

Variabel	Bawaan	Keterangan
`SIGNUP_ENABLED`	`false`	Pendaftaran mandiri. Dengan `false`, pendaftaran tetap bisa lewat tautan undangan.
`ALLOW_UNVERIFIED_LOGIN`	`false`	Izinkan login sebelum e-mail terverifikasi (sementara saja, bila SMTP belum beres).
`DEFAULT_MAX_WORKSPACES`, `DEFAULT_MAX_DEVICES`, `DEFAULT_MAX_CHANNELS`	`1`, `1`, `1`	Kuota akun baru. `-1` = tanpa batas. Akun lama tanpa batas.
`ADMIN_USERNAME`, `ADMIN_PASSWORD_HASH`, `ADMIN_SESSION_TTL`	kosong, kosong, `8h`	Konsol admin (Konsol admin). Kosong = konsol mati.
`INVITATION_TTL`	`168h`	Masa berlaku undangan dan tawaran pemindahan kepemilikan.
`WORKSPACE_DELETE_GRACE`	`168h`	Masa tenggang penghapusan workspace. `0` = langsung permanen.
`AUDIT_RETENTION`	`4320h` (180 hari)	Retensi journal.
`GROUPS_MAX_DEPTH`	`10`	Kedalaman maksimum hierarki group (1 sampai 50).

E-mail

Variabel	Keterangan
`SMTP_HOST`, `SMTP_PORT`, `SMTP_USER`, `SMTP_PASSWORD`	Server SMTP. `SMTP_HOST` harus persis seperti nama di sertifikat.
`SMTP_SECURITY`	`auto` (465 = TLS implisit, lainnya STARTTLS), `implicit`, atau `starttls`.
`SMTP_FROM`	Pengirim, misalnya `"Celestian <no-reply@contoh.id>"`.

MQTT dan perangkat

Variabel	Bawaan	Keterangan
`MQTT_BIND`, `MQTT_PORT`, `MQTT5_PORT`	`127.0.0.1`, `1883`, `1884`	Alamat bind dan port MQTT 3.1.1 dan MQTT 5. Auth callout aktif, jadi `0.0.0.0` boleh dibuka.
`MQTTS_PORT`, `MQTTS_BIND`	`8883`	MQTT dengan TLS (MQTTS dan NTP).
`MQTTS_CERT_DIR`, `MQTTS_CERT_FILE`, `MQTTS_KEY_FILE`, `MQTTS_RELOAD_CHECK_S`		Sumber sertifikat dan selang pemeriksaan (bawaan 300 detik).
`BOOTSTRAP_BROKER_URL`		Alamat broker untuk device (`mqtt://host:1883`): dipakai tab Credentials dan template Bootstrap.
`BROKERAUTH_CLIENT_ID_POLICY`	`prefix` (produksi)	`prefix`: client ID harus diawali ID device. `any` untuk development.
`PRESENCE_RELAYED_OFFLINE_AFTER`	`15m`	Sensor di belakang gateway dianggap offline bila tidak ada data selama ini atau gateway offline.
`SENFLAT_DEDUP_TTL`	`72h`	Lama nomor `q` SenFlat v2 diingat untuk membuang duplikat.
`DEVICECONFIG_RECONCILE_INTERVAL`, `DEVICECONFIG_MAX_RESENDS`, `DEVICECONFIG_ROLLOUT_INTERVAL`	`30s`, `10`, `15s`	Penyelaras konfigurasi dan rollout rules. `0` = mati.

Rules dan laporan

Variabel	Bawaan	Keterangan
`RULES_ALLOW_PRIVATE_TARGETS`	`false`	Izinkan output PostgreSQL, Webhook, Telegram menuju alamat privat atau lokal.
`RULES_LUA_TIMEOUT`	`500ms`	Batas waktu logic Lua.
`RULES_GO_WORKERS`, `RULES_GO_TIMEOUT`, `RULES_GO_MEMORY_MB`	`2`, `500ms`, `256`	Pekerja logic Go. `0` pekerja = Go nonaktif.
`RULES_GO_ISOLATION`, `RULES_GO_NAMESPACES`	`auto`, `false`	Isolasi OS pekerja Go di Linux: `auto`, `strict`, atau `off`.
`REPORTS_PDF_URL`		Layanan render PDF (`http://gotenberg:3000`). Kosong = report hanya CSV.
`REPORTS_PDF_TIMEOUT`	`60s`
`REPORTS_MAX_ROWS`, `REPORTS_MAX_FILE_BYTES`, `REPORTS_RETENTION`, `REPORTS_WORKERS`	`200000`, 25 MiB, `720h`, `2`	Batas report.
`PDF_MEM_LIMIT`	`1g`	Batas memori layanan PDF.

Firmware dan peta

Variabel	Bawaan	Keterangan
`FIRMWARE_MAX_BYTES`	`8388608`	Ukuran maksimum satu berkas firmware.
`FIRMWARE_URL_TTL`	`720h`	Umur alamat unduhan bertanda tangan.
`OTA_INTERVAL`	`15s`	Jeda sapuan mesin rollout. `0` = mati.
`MAP_TILE_URL`, `MAP_TILE_ATTRIBUTION`	OpenStreetMap	Ubin peta untuk editor metadata dan widget peta. Isi server ubin sendiri di jaringan tertutup.

Backup

Variabel	Bawaan	Keterangan
`BACKUP_DIR`	`./backups`	Folder hasil backup.
`BACKUP_KEEP_DAYS`	`7`	Lama penyimpanan.