On this page
settings
Referensi Konfigurasi
Referensi lengkap untuk semua variabel lingkungan yang digunakan untuk mengonfigurasi penerapan rtCloud yang di-hosting sendiri.
Semua konfigurasi dilakukan melalui variabel lingkungan dalam file .env di root direktori penerapan Anda. Docker Compose membaca file ini secara otomatis — tidak diperlukan flag --env-file.
Variabel yang ditandai diperlukan harus ditetapkan sebelum memulai container. Semua variabel lainnya memiliki nilai default dan bersifat opsional.
Proyek
Variabel-variabel ini mendefinisikan identitas dan titik akses instans rtCloud Anda.
| Variabel | Default | Diperlukan | Deskripsi |
|---|---|---|---|
PROJECT_ID | — | Ya | Pengidentifikasi unik untuk penerapan ini. Tanpa spasi atau karakter khusus. Digunakan sebagai awalan untuk penamaan internal. |
PROJECT_URL | — | Ya | Nama domain atau alamat IP tempat pengguna mengakses aplikasi (misalnya, rtcloud.example.com atau 192.168.1.100). |
PROJECT_TYPE | rtsurvey | Tidak | Varian platform yang diaktifkan. Opsi: rtwork, rtsurvey, rthome. |
PROJECT_PORT | 80 | Tidak | Port yang didengarkan aplikasi di dalam container. Jangan ubah kecuali Anda tahu apa yang Anda lakukan. |
HTTP_PROTOCOL | https | Tidak | Protokol yang digunakan untuk membuat URL internal. Atur ke http jika Anda tidak menggunakan SSL. |
Database
Kredensial koneksi MySQL. Database dikelola secara otomatis oleh container MySQL — Anda hanya perlu menetapkan kata sandi yang kuat.
| Variabel | Default | Diperlukan | Deskripsi |
|---|---|---|---|
MYSQL_DATABASE | smartsurvey | Tidak | Nama database aplikasi. |
MYSQL_USER | smartsurvey | Tidak | Pengguna MySQL untuk aplikasi. |
MYSQL_PASSWORD | — | Ya | Kata sandi untuk MYSQL_USER. Gunakan nilai yang kuat dan unik. |
MYSQL_ROOT_PASSWORD | — | Ya | Kata sandi root MySQL. Diperlukan untuk inisialisasi database dan operasi admin. |
MYSQL_HOST | mysql | Tidak | Nama host MySQL. Gunakan default kecuali Anda terhubung ke database eksternal. |
MYSQL_PORT | 3306 | Tidak | Port MySQL. |
Akun Admin
Akun admin dibuat secara otomatis pada booting pertama database baru.
| Variabel | Default | Diperlukan | Deskripsi |
|---|---|---|---|
ADMIN_PASSWORD | admin | Ya | Kata sandi untuk pengguna admin bawaan. Atur ini sebelum booting pertama. Tidak berpengaruh jika database sudah ada. |
Setelah login pertama, ubah kata sandi admin dari halaman Pengaturan Akun di UI web.
Port
Kontrol port host mana yang diikat aplikasi.
| Variabel | Default | Deskripsi |
|---|---|---|
APP_PORT | 8080 | Port host untuk UI web utama. Ubah ini jika port 8080 sudah digunakan di server Anda. |
SHINY_PORT | 3838 | Port host untuk server analitik Shiny. |
Runtime
| Variabel | Default | Deskripsi |
|---|---|---|
RUN_ENV | prod | Lingkungan runtime. Gunakan prod untuk penerapan produksi, dev untuk pengembangan lokal. |
RUN_MODE | admin | Peran container. admin menjalankan stack penuh (web + antrian + cron). worker hanya menjalankan pemrosesan latar belakang (untuk penskalaan horizontal). |
TZ | Asia/Ho_Chi_Minh | Zona waktu server. Memengaruhi cap waktu log, jadwal cron, dan tampilan tanggal. Gunakan nama database TZ (misalnya, UTC, America/New_York, Europe/London). |
LOG_LEVEL | info | Verbositas log aplikasi. Opsi: debug, info, warning, error. |
COMPOSE_PROJECT_NAME | rtcloud | Awalan yang diterapkan ke semua nama container dan volume Docker. Ubah ini saat menjalankan beberapa instans rtCloud di host yang sama. |
RESTART_POLICY | unless-stopped | Perilaku restart container Docker. Opsi: no, always, on-failure, unless-stopped. |
RTCLOUD_IMAGE | rtawebteam/rta-smartsurvey:survey-dockerize | Image Docker yang digunakan. Ubah tag untuk menyematkan versi tertentu. |
REQUIRE_LICENSE | false | Aktifkan validasi kunci lisensi saat startup. Hubungi RTA untuk informasi lisensi. |
Keamanan
| Variabel | Default | Deskripsi |
|---|---|---|
CSRF_VALIDATION_ENABLED | true | Aktifkan validasi token CSRF. Pertahankan true di produksi. Atur ke false hanya dalam pengembangan lokal jika Anda mengalami kesalahan 400 CSRF token could not be verified. |
GII_ENABLED | false | Aktifkan alat pembuat kode framework Yii. Jangan pernah aktifkan di produksi. |
SSO — Keycloak Tertanam
Aktifkan container Keycloak yang dibundel untuk SSO perusahaan berfitur lengkap. Memerlukan domain dengan HTTPS.
| Variabel | Default | Deskripsi |
|---|---|---|
EMBED_KEYCLOAK | false | Atur ke true untuk memulai container Keycloak tertanam. Mengaktifkan profil Docker Compose embed-keycloak. |
KEYCLOAK_URL | — | URL lengkap server Keycloak (misalnya, https://rtcloud.example.com/auth). |
KEYCLOAK_REALM | — | Nama realm Keycloak (misalnya, rtsurvey). |
KEYCLOAK_CLIENT_ID | — | ID klien Keycloak untuk aplikasi rtCloud. |
KEYCLOAK_CLIENT_SECRET | — | Secret klien Keycloak. Buat ini dari konsol admin Keycloak. |
KEYCLOAK_ADMIN_USER | admin | Nama pengguna administrator Keycloak. |
KEYCLOAK_ADMIN_PASSWORD | — | Kata sandi administrator Keycloak. |
KEYCLOAK_DB | keycloak | Nama database untuk Keycloak. Dibuat secara otomatis pada booting pertama. |
KEYCLOAK_DB_USER | keycloak | Pengguna database untuk Keycloak. |
KEYCLOAK_DB_PASSWORD | — | Kata sandi database untuk pengguna Keycloak. |
KC_HOSTNAME | — | URL frontend Keycloak (misalnya, https://rtcloud.example.com/auth). |
KC_HOSTNAME_STRICT | false | Terapkan pencocokan nama host yang ketat. Atur ke true di produksi dengan domain tetap. |
Lihat Autentikasi SSO untuk panduan pengaturan lengkap.
SSO — Penyedia OIDC Eksternal
Hubungkan ke penyedia identitas yang kompatibel dengan OIDC yang sudah ada (Supabase, Auth0, Authentik, Okta, dll.).
| Variabel | Default | Deskripsi |
|---|---|---|
OIDC_ISSUER_URL | — | URL penemuan issuer OIDC (misalnya, https://accounts.google.com). |
OIDC_CLIENT_ID | — | ID klien yang terdaftar di penyedia identitas Anda. |
OIDC_CLIENT_SECRET | — | Secret klien dari penyedia identitas Anda. |
OIDC_SCOPE | openid profile email | Daftar scope OIDC yang dipisahkan spasi untuk diminta. |
OIDC_REDIRECT_URI | — | URL callback untuk aplikasi web (misalnya, https://rtcloud.example.com/auth/callback). |
OIDC_MOBILE_CLIENT_ID | — | ID klien terpisah untuk aplikasi mobile rtSurvey. |
OIDC_MOBILE_REDIRECT_URI | — | URI callback aplikasi mobile (misalnya, vn.rta.rtsurvey.auth://callback). |
OPEN_REGISTRATION | false | Secara otomatis membuat akun rtCloud untuk pengguna yang pertama kali mengautentikasi melalui OIDC. |
OIDC_AUTHORIZATION_ENDPOINT | — | Timpa URL endpoint otorisasi (biarkan kosong untuk menggunakan penemuan). |
OIDC_TOKEN_ENDPOINT | — | Timpa URL endpoint token (biarkan kosong untuk menggunakan penemuan). |
OIDC_USERINFO_ENDPOINT | — | Timpa URL endpoint userinfo (biarkan kosong untuk menggunakan penemuan). |
SSO — Azure Active Directory
| Variabel | Deskripsi |
|---|---|
AZURE_CLIENT_ID | ID aplikasi (klien) Azure AD. |
AZURE_TENANT_ID | ID direktori (tenant) Azure AD. |
Integrasi Opsional
Stata
| Variabel | Default | Deskripsi |
|---|---|---|
STATA_ENABLED | false | Aktifkan integrasi perangkat lunak statistik Stata untuk analisis data. |
STATA_BIN_PATH | /usr/bin/stata | Path absolut ke binary Stata di dalam container. |
Elasticsearch
| Variabel | Deskripsi |
|---|---|
ES_HOST | Host Elasticsearch (misalnya, http://elasticsearch:9200). |
ES_PORT | Port Elasticsearch. |
Analitik Matomo
| Variabel | Deskripsi |
|---|---|
PIWIK_URL | URL server Matomo (Piwik). |
PIWIK_ID | ID situs Matomo. |
PIWIK_SECRET | Token autentikasi Matomo. |
OpenCPU (Komputasi R)
| Variabel | Deskripsi |
|---|---|
OCPU_HOST | URL server OpenCPU untuk komputasi statistik berbasis R. |
Integrasi RtBox
| Variabel | Deskripsi |
|---|---|
RTBOX_HOST | URL host layanan RtBox. |
RTBOX_USER_API | Kunci API pengguna RtBox. |
RTBOX_BASIC_AUTH | Kredensial autentikasi dasar untuk RtBox. |
Pesan Matrix
| Variabel | Deskripsi |
|---|---|
MATRIX_HOMESERVER_HOST | Host homeserver Matrix. |
MATRIX_HOMESERVER_PORT | Port homeserver Matrix. |
Volume Data
Semua data aplikasi disimpan dalam volume Docker bernama. Volume dibuat secara otomatis pada startup pertama dan bertahan di antara restart dan pembaruan container.
| Volume | Titik Mount | Konten |
|---|---|---|
rtcloud_mysql_data | /var/lib/mysql | File database MySQL |
rtcloud_uploads | …/uploads | File yang diunggah oleh responden survei |
rtcloud_audios | …/audios | Rekaman audio |
rtcloud_downloads | …/downloads | File ekspor yang dibuat |
rtcloud_gallery | …/gallery | Gambar galeri |
rtcloud_voicemail | …/voicemail | Rekaman pesan suara |
rtcloud_analytics | …/analytics | Data analitik |
rtcloud_aggregate | …/aggregate | Hasil survei yang diagregasi |
rtcloud_converter | …/converter | Output konversi data |
rtcloud_shiny_data | /srv/shiny-server/smartsurvey | Skrip R server Shiny |
rtcloud_shiny_logs | /var/log/shiny-server | Log server Shiny |
rtcloud_assets | …/assets | Aset web (CSS, JS) |
rtcloud_runtime | …/protected/runtime | Cache runtime aplikasi |
rtcloud_cache | …/cache | Cache aplikasi |
rtcloud_tmp | …/tmp | File sementara |
Nama volume diawali dengan nilai COMPOSE_PROJECT_NAME (default: rtcloud).
Daftar semua volume untuk penerapan Anda:
docker volume ls | grep rtcloud
Apakah halaman ini membantu?