On this page
settings
Referencia konfigurácie
Úplná referencia pre všetky premenné prostredia používané na konfiguráciu vlastného nasadenia rtCloud.
Všetka konfigurácia sa vykonáva prostredníctvom premenných prostredia v súbore .env v koreňovom adresári vášho nasadenia. Docker Compose číta tento súbor automaticky — nie je potrebný príznak --env-file.
Premenné označené ako povinné musia byť nastavené pred spustením kontajnerov. Všetky ostatné majú predvolené hodnoty a sú voliteľné.
Projekt
Tieto premenné definujú identitu a prístupový bod vašej inštancie rtCloud.
| Premenná | Predvolená | Povinná | Popis |
|---|---|---|---|
PROJECT_ID | — | Áno | Jedinečný identifikátor pre toto nasadenie. Bez medzier alebo špeciálnych znakov. Používa sa ako predpona pre interné pomenovanie. |
PROJECT_URL | — | Áno | Doménové meno alebo IP adresa, kde používatelia pristupujú k aplikácii (napr. rtcloud.example.com alebo 192.168.1.100). |
PROJECT_TYPE | rtsurvey | Nie | Varianta platformy na aktiváciu. Možnosti: rtwork, rtsurvey, rthome. |
PROJECT_PORT | 80 | Nie | Port, na ktorom aplikácia počúva vo vnútri kontajnera. Nemeňte, pokiaľ nevieme čo robíte. |
HTTP_PROTOCOL | https | Nie | Protokol používaný na konštrukciu interných URL. Nastavte na http, ak nepoužívate SSL. |
Databáza
Prihlasovacie údaje pre pripojenie k MySQL. Databáza je automaticky spravovaná kontajnerom MySQL — stačí nastaviť silné heslá.
| Premenná | Predvolená | Povinná | Popis |
|---|---|---|---|
MYSQL_DATABASE | smartsurvey | Nie | Názov aplikačnej databázy. |
MYSQL_USER | smartsurvey | Nie | Používateľ MySQL pre aplikáciu. |
MYSQL_PASSWORD | — | Áno | Heslo pre MYSQL_USER. Použite silnú, jedinečnú hodnotu. |
MYSQL_ROOT_PASSWORD | — | Áno | Heslo root pre MySQL. Vyžadované na inicializáciu databázy a operácie správcu. |
MYSQL_HOST | mysql | Nie | Hostiteľské meno MySQL. Použite predvolenú hodnotu, pokiaľ sa nepripájate k externej databáze. |
MYSQL_PORT | 3306 | Nie | Port MySQL. |
Účet správcu
Účet správcu sa automaticky vytvorí pri prvom spustení čerstvej databázy.
| Premenná | Predvolená | Povinná | Popis |
|---|---|---|---|
ADMIN_PASSWORD | admin | Áno | Heslo pre vstavaného používateľa admin. Nastavte pred prvým spustením. Nemá žiadny účinok, ak databáza už existuje. |
Po prvom prihlásení zmeňte heslo správcu na stránke Nastavenia účtu vo webovom rozhraní.
Porty
Kontrolujte, na ktoré hostiteľské porty sa aplikácia viaže.
| Premenná | Predvolená | Popis |
|---|---|---|
APP_PORT | 8080 | Hostiteľský port pre hlavné webové používateľské rozhranie. Zmeňte, ak je port 8080 na vašom serveri už používaný. |
SHINY_PORT | 3838 | Hostiteľský port pre analytický server Shiny. |
Runtime
| Premenná | Predvolená | Popis |
|---|---|---|
RUN_ENV | prod | Prostredí runtime. Použite prod pre produkčné nasadenia, dev pre lokálny vývoj. |
RUN_MODE | admin | Rola kontajnera. admin spúšťa celý zásobník (web + fronta + cron). worker spúšťa iba spracovanie na pozadí (pre horizontálne škálovanie). |
TZ | Asia/Ho_Chi_Minh | Časové pásmo servera. Ovplyvňuje časové pečiatky v protokoloch, plány cron a zobrazenie dátumu. Použite názov časového pásma z databázy TZ (napr. UTC, America/New_York, Europe/London). |
LOG_LEVEL | info | Podrobnosť protokolov aplikácie. Možnosti: debug, info, warning, error. |
COMPOSE_PROJECT_NAME | rtcloud | Predpona aplikovaná na všetky názvy Docker kontajnerov a zväzkov. Zmeňte pri spustení viacerých inštancií rtCloud na tom istom hostiteľovi. |
RESTART_POLICY | unless-stopped | Správanie reštartu Docker kontajnera. Možnosti: no, always, on-failure, unless-stopped. |
RTCLOUD_IMAGE | rtawebteam/rta-smartsurvey:survey-dockerize | Docker image na použitie. Zmeňte tag na pripnutie konkrétnej verzie. |
REQUIRE_LICENSE | false | Aktivovanie overenia licenčného kľúča pri spustení. Kontaktujte RTA pre informácie o licencii. |
Bezpečnosť
| Premenná | Predvolená | Popis |
|---|---|---|
CSRF_VALIDATION_ENABLED | true | Aktivovanie overenia CSRF tokenu. Ponechajte na true v produkcii. Nastavte na false iba v lokálnom vývoji, ak sa vyskytujú chyby 400 CSRF token could not be verified. |
GII_ENABLED | false | Aktivovanie nástroja na generovanie kódu frameworku Yii. Nikdy neaktivujte v produkcii. |
SSO — Vstavaný Keycloak
Aktivovanie zabudovaného kontajnera Keycloak pre plnohodnotné podnikové SSO. Vyžaduje doménu s HTTPS.
| Premenná | Predvolená | Popis |
|---|---|---|
EMBED_KEYCLOAK | false | Nastavte na true na spustenie vstavaného kontajnera Keycloak. Aktivuje profil Docker Compose embed-keycloak. |
KEYCLOAK_URL | — | Úplná URL adresa servera Keycloak (napr. https://rtcloud.example.com/auth). |
KEYCLOAK_REALM | — | Názov realmu Keycloak (napr. rtsurvey). |
KEYCLOAK_CLIENT_ID | — | ID klienta Keycloak pre aplikáciu rtCloud. |
KEYCLOAK_CLIENT_SECRET | — | Tajomstvo klienta Keycloak. Generujte z administrátorskej konzoly Keycloak. |
KEYCLOAK_ADMIN_USER | admin | Používateľské meno správcu Keycloak. |
KEYCLOAK_ADMIN_PASSWORD | — | Heslo správcu Keycloak. |
KEYCLOAK_DB | keycloak | Názov databázy pre Keycloak. Vytvorí sa automaticky pri prvom spustení. |
KEYCLOAK_DB_USER | keycloak | Používateľ databázy pre Keycloak. |
KEYCLOAK_DB_PASSWORD | — | Heslo databázy pre používateľa Keycloak. |
KC_HOSTNAME | — | URL frontendu Keycloak (napr. https://rtcloud.example.com/auth). |
KC_HOSTNAME_STRICT | false | Vynucovanie prísneho zhody hostiteľského mena. Nastavte na true v produkcii s pevnou doménou. |
Pozrite si SSO autentifikácia pre úplného sprievodcu nastavením.
SSO — Externý poskytovateľ OIDC
Pripojenie k existujúcemu poskytovateľovi identity kompatibilnému s OIDC (Supabase, Auth0, Authentik, Okta atď.).
| Premenná | Predvolená | Popis |
|---|---|---|
OIDC_ISSUER_URL | — | URL na objavenie vydavateľa OIDC (napr. https://accounts.google.com). |
OIDC_CLIENT_ID | — | ID klienta zaregistrované u vášho poskytovateľa identity. |
OIDC_CLIENT_SECRET | — | Tajomstvo klienta od vášho poskytovateľa identity. |
OIDC_SCOPE | openid profile email | Zoznam rozsahov OIDC oddelených medzerou na žiadosť. |
OIDC_REDIRECT_URI | — | URL spätného volania pre webovú aplikáciu (napr. https://rtcloud.example.com/auth/callback). |
OIDC_MOBILE_CLIENT_ID | — | Samostatné ID klienta pre mobilnú aplikáciu rtSurvey. |
OIDC_MOBILE_REDIRECT_URI | — | URI spätného volania mobilnej aplikácie (napr. vn.rta.rtsurvey.auth://callback). |
OPEN_REGISTRATION | false | Automatické vytváranie účtov rtCloud pre používateľov, ktorí sa prvýkrát autentifikujú cez OIDC. |
OIDC_AUTHORIZATION_ENDPOINT | — | Prepísanie URL koncového bodu autorizácie (ponechajte prázdne na použitie objavovania). |
OIDC_TOKEN_ENDPOINT | — | Prepísanie URL koncového bodu tokenov (ponechajte prázdne na použitie objavovania). |
OIDC_USERINFO_ENDPOINT | — | Prepísanie URL koncového bodu informácií o používateľovi (ponechajte prázdne na použitie objavovania). |
SSO — Azure Active Directory
| Premenná | Popis |
|---|---|
AZURE_CLIENT_ID | ID aplikácie (klienta) Azure AD. |
AZURE_TENANT_ID | ID adresára (tenanta) Azure AD. |
Voliteľné integrácie
Stata
| Premenná | Predvolená | Popis |
|---|---|---|
STATA_ENABLED | false | Aktivovanie integrácie štatistického softvéru Stata pre analýzu dát. |
STATA_BIN_PATH | /usr/bin/stata | Absolútna cesta k binárnemu súboru Stata vo vnútri kontajnera. |
Elasticsearch
| Premenná | Popis |
|---|---|
ES_HOST | Hostiteľ Elasticsearch (napr. http://elasticsearch:9200). |
ES_PORT | Port Elasticsearch. |
Matomo Analytics
| Premenná | Popis |
|---|---|
PIWIK_URL | URL servera Matomo (Piwik). |
PIWIK_ID | ID stránky Matomo. |
PIWIK_SECRET | Autentifikačný token Matomo. |
OpenCPU (výpočty v R)
| Premenná | Popis |
|---|---|
OCPU_HOST | URL servera OpenCPU pre štatistické výpočty na báze R. |
Integrácia RtBox
| Premenná | Popis |
|---|---|
RTBOX_HOST | URL hostiteľa služby RtBox. |
RTBOX_USER_API | API kľúč používateľa RtBox. |
RTBOX_BASIC_AUTH | Prihlasovacie údaje pre základnú autentifikáciu RtBox. |
Správy Matrix
| Premenná | Popis |
|---|---|
MATRIX_HOMESERVER_HOST | Hostiteľ domáceho servera Matrix. |
MATRIX_HOMESERVER_PORT | Port domáceho servera Matrix. |
Dátové zväzky
Všetky dáta aplikácie sú uložené v pomenovaných Docker zväzkoch. Zväzky sa automaticky vytvoria pri prvom spustení a pretrvajú cez reštarty a aktualizácie kontajnerov.
| Zväzok | Bod pripojenia | Obsah |
|---|---|---|
rtcloud_mysql_data | /var/lib/mysql | Súbory databázy MySQL |
rtcloud_uploads | …/uploads | Súbory nahrané respondentmi prieskumu |
rtcloud_audios | …/audios | Zvukové nahrávky |
rtcloud_downloads | …/downloads | Generované exportné súbory |
rtcloud_gallery | …/gallery | Obrázky galérie |
rtcloud_voicemail | …/voicemail | Nahrávky hlasovej pošty |
rtcloud_analytics | …/analytics | Analytické dáta |
rtcloud_aggregate | …/aggregate | Agregované výsledky prieskumu |
rtcloud_converter | …/converter | Výstupy konverzie dát |
rtcloud_shiny_data | /srv/shiny-server/smartsurvey | R skripty servera Shiny |
rtcloud_shiny_logs | /var/log/shiny-server | Protokoly servera Shiny |
rtcloud_assets | …/assets | Webové aktíva (CSS, JS) |
rtcloud_runtime | …/protected/runtime | Vyrovnávacia pamäť runtime aplikácie |
rtcloud_cache | …/cache | Vyrovnávacia pamäť aplikácie |
rtcloud_tmp | …/tmp | Dočasné súbory |
Názvy zväzkov majú predponu hodnoty COMPOSE_PROJECT_NAME (predvolená: rtcloud).
Výpis všetkých zväzkov pre vaše nasadenie:
docker volume ls | grep rtcloud
Bola táto stránka užitočná?