On this page
settings
Configuratiereferentie
Volledige referentie voor alle omgevingsvariabelen die worden gebruikt om een zelf gehoste rtCloud-implementatie te configureren.
Alle configuratie wordt gedaan via omgevingsvariabelen in het .env-bestand in de hoofdmap van uw implementatiemap. Docker Compose leest dit bestand automatisch — er is geen --env-file-vlag nodig.
Variabelen gemarkeerd als vereist moeten worden ingesteld voordat u de containers start. Alle andere hebben standaardwaarden en zijn optioneel.
Project
Deze variabelen definiëren de identiteit en het toegangspunt van uw rtCloud-instantie.
| Variabele | Standaard | Vereist | Beschrijving |
|---|---|---|---|
PROJECT_ID | — | Ja | Unieke identificator voor deze implementatie. Geen spaties of speciale tekens. Gebruikt als prefix voor interne naamgeving. |
PROJECT_URL | — | Ja | Domeinnaam of IP-adres waar gebruikers toegang krijgen tot de app (bijv. rtcloud.example.com of 192.168.1.100). |
PROJECT_TYPE | rtsurvey | Nee | Platformvariant om te activeren. Opties: rtwork, rtsurvey, rthome. |
PROJECT_PORT | 80 | Nee | Poort waarop de applicatie luistert binnen de container. Verander dit niet tenzij u weet wat u doet. |
HTTP_PROTOCOL | https | Nee | Protocol dat wordt gebruikt om interne URL’s te construeren. Stel in op http als u geen SSL gebruikt. |
Database
MySQL-verbindingsgegevens. De database wordt automatisch beheerd door de MySQL-container — u hoeft alleen sterke wachtwoorden in te stellen.
| Variabele | Standaard | Vereist | Beschrijving |
|---|---|---|---|
MYSQL_DATABASE | smartsurvey | Nee | Naam van de applicatiedatabase. |
MYSQL_USER | smartsurvey | Nee | MySQL-gebruiker voor de applicatie. |
MYSQL_PASSWORD | — | Ja | Wachtwoord voor MYSQL_USER. Gebruik een sterke, unieke waarde. |
MYSQL_ROOT_PASSWORD | — | Ja | MySQL-rootwachtwoord. Vereist voor database-initialisatie en beheeroperaties. |
MYSQL_HOST | mysql | Nee | MySQL-hostnaam. Gebruik de standaard tenzij u verbinding maakt met een externe database. |
MYSQL_PORT | 3306 | Nee | MySQL-poort. |
Beheerdersaccount
Het beheerdersaccount wordt automatisch aangemaakt bij de eerste start van een verse database.
| Variabele | Standaard | Vereist | Beschrijving |
|---|---|---|---|
ADMIN_PASSWORD | admin | Ja | Wachtwoord voor de ingebouwde admin-gebruiker. Stel dit in vóór de eerste start. Heeft geen effect als de database al bestaat. |
Wijzig het beheerderwachtwoord na de eerste login via de pagina Accountinstellingen in de web-UI.
Poorten
Bepaal aan welke hostpoorten de applicatie is gebonden.
| Variabele | Standaard | Beschrijving |
|---|---|---|
APP_PORT | 8080 | Hostpoort voor de hoofd web-UI. Wijzig dit als poort 8080 al in gebruik is op uw server. |
SHINY_PORT | 3838 | Hostpoort voor de Shiny-analyseserver. |
Runtime
| Variabele | Standaard | Beschrijving |
|---|---|---|
RUN_ENV | prod | Runtime-omgeving. Gebruik prod voor productie-implementaties, dev voor lokale ontwikkeling. |
RUN_MODE | admin | Containerrol. admin voert de volledige stapel uit (web + wachtrij + cron). worker voert alleen achtergrondverwerking uit (voor horizontaal schalen). |
TZ | Asia/Ho_Chi_Minh | Servertijdzone. Beïnvloedt logboektijdstempels, cron-schema’s en datumweergave. Gebruik een TZ-databasenaam (bijv. UTC, America/New_York, Europe/London). |
LOG_LEVEL | info | Uitvoerigheid van het applicatielogboek. Opties: debug, info, warning, error. |
COMPOSE_PROJECT_NAME | rtcloud | Prefix toegepast op alle Docker-container- en volumenamen. Wijzig dit wanneer u meerdere rtCloud-instanties op dezelfde host uitvoert. |
RESTART_POLICY | unless-stopped | Herstartgedrag van Docker-containers. Opties: no, always, on-failure, unless-stopped. |
RTCLOUD_IMAGE | rtawebteam/rta-smartsurvey:survey-dockerize | Te gebruiken Docker-image. Wijzig de tag om een specifieke versie vast te zetten. |
REQUIRE_LICENSE | false | Licentievalidatie bij opstarten inschakelen. Neem contact op met RTA voor licentie-informatie. |
Beveiliging
| Variabele | Standaard | Beschrijving |
|---|---|---|
CSRF_VALIDATION_ENABLED | true | CSRF-tokenvalidatie inschakelen. Houd dit true in productie. Stel in op false alleen in lokale ontwikkeling als u 400 CSRF token could not be verified-fouten tegenkomt. |
GII_ENABLED | false | Het Yii-framework codegeneratortool inschakelen. Nooit inschakelen in productie. |
SSO — Ingebedde Keycloak
Schakel de gebundelde Keycloak-container in voor volledig functionerende enterprise SSO. Vereist een domein met HTTPS.
| Variabele | Standaard | Beschrijving |
|---|---|---|
EMBED_KEYCLOAK | false | Stel in op true om de ingebedde Keycloak-container te starten. Activeert het Docker Compose-profiel embed-keycloak. |
KEYCLOAK_URL | — | Volledige URL van de Keycloak-server (bijv. https://rtcloud.example.com/auth). |
KEYCLOAK_REALM | — | Keycloak-realmnaam (bijv. rtsurvey). |
KEYCLOAK_CLIENT_ID | — | Keycloak-client-ID voor de rtCloud-applicatie. |
KEYCLOAK_CLIENT_SECRET | — | Keycloak-clientgeheim. Genereer dit vanuit de Keycloak-beheerconsole. |
KEYCLOAK_ADMIN_USER | admin | Keycloak-beheerdersgebruikersnaam. |
KEYCLOAK_ADMIN_PASSWORD | — | Keycloak-beheerderswachtwoord. |
KEYCLOAK_DB | keycloak | Databasenaam voor Keycloak. Automatisch aangemaakt bij eerste start. |
KEYCLOAK_DB_USER | keycloak | Databasegebruiker voor Keycloak. |
KEYCLOAK_DB_PASSWORD | — | Databasewachtwoord voor de Keycloak-gebruiker. |
KC_HOSTNAME | — | Keycloak frontend-URL (bijv. https://rtcloud.example.com/auth). |
KC_HOSTNAME_STRICT | false | Strikte hostnaamovereenkomst afdwingen. Stel in op true in productie met een vast domein. |
Zie SSO-authenticatie voor de volledige installatiegids.
SSO — Externe OIDC-provider
Verbind met een bestaande OIDC-compatibele identiteitsprovider (Supabase, Auth0, Authentik, Okta, enz.).
| Variabele | Standaard | Beschrijving |
|---|---|---|
OIDC_ISSUER_URL | — | OIDC-uitgeversontdekking-URL (bijv. https://accounts.google.com). |
OIDC_CLIENT_ID | — | Client-ID geregistreerd bij uw identiteitsprovider. |
OIDC_CLIENT_SECRET | — | Clientgeheim van uw identiteitsprovider. |
OIDC_SCOPE | openid profile email | Spatie-gescheiden lijst van te verzoeken OIDC-scopes. |
OIDC_REDIRECT_URI | — | Callback-URL voor de webapp (bijv. https://rtcloud.example.com/auth/callback). |
OIDC_MOBILE_CLIENT_ID | — | Afzonderlijke client-ID voor de rtSurvey mobiele app. |
OIDC_MOBILE_REDIRECT_URI | — | Callback-URI voor de mobiele app (bijv. vn.rta.rtsurvey.auth://callback). |
OPEN_REGISTRATION | false | Automatisch rtCloud-accounts aanmaken voor gebruikers die zich voor het eerst authenticeren via OIDC. |
OIDC_AUTHORIZATION_ENDPOINT | — | Het autorisatie-eindpunt-URL overschrijven (leeg laten om ontdekking te gebruiken). |
OIDC_TOKEN_ENDPOINT | — | Het token-eindpunt-URL overschrijven (leeg laten om ontdekking te gebruiken). |
OIDC_USERINFO_ENDPOINT | — | Het gebruikersinformatie-eindpunt-URL overschrijven (leeg laten om ontdekking te gebruiken). |
SSO — Azure Active Directory
| Variabele | Beschrijving |
|---|---|
AZURE_CLIENT_ID | Azure AD-applicatie (client) ID. |
AZURE_TENANT_ID | Azure AD-directory (tenant) ID. |
Optionele integraties
Stata
| Variabele | Standaard | Beschrijving |
|---|---|---|
STATA_ENABLED | false | Stata-integratie voor statistische softwareanalyse inschakelen. |
STATA_BIN_PATH | /usr/bin/stata | Absoluut pad naar het Stata-binair bestand binnen de container. |
Elasticsearch
| Variabele | Beschrijving |
|---|---|
ES_HOST | Elasticsearch-host (bijv. http://elasticsearch:9200). |
ES_PORT | Elasticsearch-poort. |
Matomo Analytics
| Variabele | Beschrijving |
|---|---|
PIWIK_URL | Matomo (Piwik) server-URL. |
PIWIK_ID | Matomo-site-ID. |
PIWIK_SECRET | Matomo-authenticatietoken. |
OpenCPU (R-berekening)
| Variabele | Beschrijving |
|---|---|
OCPU_HOST | OpenCPU-server-URL voor op R gebaseerde statistische berekening. |
RtBox-integratie
| Variabele | Beschrijving |
|---|---|
RTBOX_HOST | RtBox-servicehost-URL. |
RTBOX_USER_API | RtBox-gebruikers-API-sleutel. |
RTBOX_BASIC_AUTH | Basisauthenticatiegegevens voor RtBox. |
Matrix Messaging
| Variabele | Beschrijving |
|---|---|
MATRIX_HOMESERVER_HOST | Matrix-homeserverhost. |
MATRIX_HOMESERVER_PORT | Matrix-homeserverpoort. |
Gegevensvolumes
Alle applicatiegegevens worden opgeslagen in benoemde Docker-volumes. Volumes worden automatisch aangemaakt bij de eerste start en blijven bestaan bij het herstarten en bijwerken van containers.
| Volume | Koppelpunt | Inhoud |
|---|---|---|
rtcloud_mysql_data | /var/lib/mysql | MySQL-databasebestanden |
rtcloud_uploads | …/uploads | Bestanden geüpload door enquêterespondenten |
rtcloud_audios | …/audios | Audio-opnames |
rtcloud_downloads | …/downloads | Gegenereerde exportbestanden |
rtcloud_gallery | …/gallery | Galerij-afbeeldingen |
rtcloud_voicemail | …/voicemail | Voicemailopnames |
rtcloud_analytics | …/analytics | Analysegegevens |
rtcloud_aggregate | …/aggregate | Geaggregeerde enquêteresultaten |
rtcloud_converter | …/converter | Gegevensconversieuitvoer |
rtcloud_shiny_data | /srv/shiny-server/smartsurvey | Shiny-server R-scripts |
rtcloud_shiny_logs | /var/log/shiny-server | Shiny-serverlogboeken |
rtcloud_assets | …/assets | Webactiva (CSS, JS) |
rtcloud_runtime | …/protected/runtime | Applicatieruntimecache |
rtcloud_cache | …/cache | Applicatiecache |
rtcloud_tmp | …/tmp | Tijdelijke bestanden |
Volumenamen worden voorafgegaan door de waarde van COMPOSE_PROJECT_NAME (standaard: rtcloud).
Geef alle volumes voor uw implementatie weer:
docker volume ls | grep rtcloud
Was deze pagina nuttig?