Perintah dan skrip

Subperintah `celestian`

Binary yang sama dipakai untuk menjalankan server dan untuk perintah administrasi (di image api).

Perintah	Fungsi
`celestian --role=all`	Menjalankan semua peran (bawaan di image).
`celestian --role=api,brokerauth,...`	Menjalankan peran tertentu, dipisah koma: `api`, `brokerauth`, `presence`, `rules`, `reports`.
`celestian migrate`	Hanya menjalankan migrasi lalu keluar.
`celestian healthcheck`	Memeriksa `/readyz` lokal (dipakai `HEALTHCHECK` Docker).
`celestian smtp-test <alamat>`	Mengirim satu e-mail uji dengan `SMTP_*` dari env; mencetak galat aslinya bila gagal.
`celestian hash-password`	Membaca password dari stdin dan mencetak baris `ADMIN_PASSWORD_HASH='…'` (minimal 12 karakter).

Di server, jalankan dari folder deploy/ lewat Compose. --no-deps mencegah layanan lain ikut naik, dan -T wajib bila stdin dipipa:

docker compose run --rm --no-deps api smtp-test tujuan@contoh.id

read -rsp 'Password admin (min. 12 karakter): ' PW; echo
printf '%s' "$PW" | docker compose run --rm --no-deps -T api hash-password
unset PW

Keluaran hash-password adalah satu baris. Salin apa adanya, dengan kutip tunggal, ke deploy/.env.

Skrip di `deploy/scripts`

Skrip	Fungsi
`gen-secrets.sh`	Membuat `deploy/.env` dari contoh dengan secret acak. Tidak menimpa `.env` yang ada. Jalankan sekali.
`backup.sh`	Backup PostgreSQL dan TimescaleDB; simpan `BACKUP_KEEP_DAYS` hari.
`make-tls-cert.sh`	Membuat CA sendiri dan sertifikat server untuk MQTTS.
`pull-tls-cert.sh`	Menarik sertifikat dari server lain lewat SSH.

Docker Compose (dari `deploy/`)

Perintah	Fungsi
`docker compose config --quiet`	Memvalidasi compose dan `.env`.
`docker compose pull`	Mengambil image sesuai `API_IMAGE` dan `WEB_IMAGE`.
`docker compose up -d`	Menjalankan atau menerapkan perubahan `.env` dan image. `restart` saja tidak membaca `.env` baru.
`docker compose ps`	Status kontainer.
`docker compose logs -f api`	Log (`web`, `fluxmq`, dan lainnya juga bisa).
`docker compose down`	Menghentikan stack; data di `DATA_DIR` tetap.

Versi

Versi aplikasi tampil di dialog Tentang (menu pengguna), lengkap dengan peringatan bila versi API dan web berbeda.