Studio Environment Variables - Rasa Documentation

Server

The Studio server handles the API, user authentication, assistant configuration, and conversation storage.

Core

Environment Variable	Description	Default
`RASA_PRO_LICENSE`	The Rasa Pro license key.
`OPENAI_API_KEY`	The OpenAI API key for LLM-powered features.
`HTTP_REQUEST_TIMEOUT`	The HTTP request timeout in milliseconds. Set this higher than your load balancer timeout to avoid premature connection drops.	`61000`

Database

The database stores conversations, assistant configurations, and analytics data. Both the Studio server and the event ingestion service use this same database connection.

Environment Variable	Description	Default
`DB_HOST`	The hostname of the PostgreSQL database.
`DB_PORT`	The port of the PostgreSQL database.	`5432`
`DB_NAME`	The name of the PostgreSQL database.	`studio`
`DB_USER`	The username for the PostgreSQL database.
`DB_PASS`	The password for the PostgreSQL database.
`DB_QUERY`	Additional connection query parameters.
`DB_TRANSACTION_TIMEOUT`	The database transaction timeout in milliseconds.	`10000`
`USE_AWS_IAM_AUTH`	Set to `true` to use AWS IAM authentication for the database instead of username/password.	`false`
`AWS_REGION`	The AWS region for IAM authentication. Required if `USE_AWS_IAM_AUTH` is `true`.
`IAM_DB_USER`	The IAM database username. Required if `USE_AWS_IAM_AUTH` is `true`.

Authentication

Studio uses Keycloak for identity and access management.

Environment Variable	Description	Default
`KEYCLOAK_REALM`	The Keycloak realm name.	`rasa-studio`
`KEYCLOAK_CLIENT_ID`	The Keycloak client ID for the Studio backend.	`rasa-studio-backend`
`KEYCLOAK_ADMIN_USERNAME`	The Keycloak admin username.	`kcadmin`
`KEYCLOAK_ADMIN_PASSWORD`	The Keycloak admin password.
`KEYCLOAK_API_USERNAME`	The username for Keycloak realm management API calls.	`realmadmin`
`KEYCLOAK_API_PASSWORD`	The password for Keycloak realm management API calls.
`KEYCLOAK_API_CLIENT_ID`	The client ID for Keycloak API authentication.	`admin-cli`

Model Server

Environment Variable	Description	Default
`MS_API_URL`	The URL of the Rasa model server API.	`http://rasapro`

Conversation Management

Environment Variable	Description	Default
`DELETE_CONVERSATIONS_OLDER_THAN_HOURS`	Delete conversations older than this many hours. When not set, conversations are retained indefinitely.
`DELETE_CONVERSATIONS_CRON_EXPRESSION`	Cron expression controlling when the conversation deletion job runs.	`0 * * * *`
`VERSION_DAILY_STATISTICS_CRON_EXPRESSION`	Cron expression controlling when daily version statistics are computed.	`0 0 * * *`

Voice

Environment Variable	Description	Default
`BROWSER_AUDIO_MONITOR_SILENCE`	Set to `false` to disable silence detection in audio sessions.	`true`
`BROWSER_AUDIO_ASR`	The speech-to-text (ASR) provider name.	`deepgram`
`BROWSER_AUDIO_TTS`	The text-to-speech (TTS) provider name.	`cartesia`
`DEEPGRAM_API_KEY`	The Deepgram API key for speech-to-text.
`CARTESIA_API_KEY`	The Cartesia API key for text-to-speech.

To enable voice features, you must set both DEEPGRAM_API_KEY and CARTESIA_API_KEY, even if you are only using one of the providers for both speech-to-text and text-to-speech. In such a case, set the unused provider’s environment variable to a placeholder value (e.g., CARTESIA_API_KEY=unused).

Observability

Environment Variable	Description	Default
`LOG_LEVEL_DEBUG`	Set to `true` to enable debug-level logging.	`false`
`LOG_FILE`	Path to a file where logs are written. When not set, logs go to stdout only.

Advanced

Environment Variable	Description	Default
`TRAINING_POLLING_INTERVAL_MS`	Interval in milliseconds at which Studio polls for model training status. Minimum value: `1000`.	`1000`
`MODEL_POLLING_INTERVAL_MS`	Interval in milliseconds at which Studio polls for model deployment status. Minimum value: `2000`.	`2000`
`MODEL_INACTIVE_AFTER_MS`	Time in milliseconds after which a running model version is marked as inactive. Minimum value: `60000`.	`3600000`

Event Ingestion

Studio consumes Rasa events from a Kafka topic to power analytics and conversation review. Ingested events are persisted to the same PostgreSQL database configured in the Database section above.

Kafka

Environment Variable	Description	Default
`KAFKA_BROKER_ADDRESS`	The address of the Kafka broker.
`KAFKA_TOPIC`	The Kafka topic that Rasa publishes events to.	`rasa-events`
`KAFKA_DLQ_TOPIC`	The Kafka dead letter queue topic for events that fail processing.	`rasa-events-dlq`
`KAFKA_CLIENT_ID`	The Kafka client identifier.	`kafka-python-rasa`
`KAFKA_GROUP_ID`	The Kafka consumer group ID.	`studio`
`KAFKA_SASL_MECHANISM`	The SASL mechanism for Kafka authentication (e.g. `PLAIN`, `SCRAM-SHA-256`).
`KAFKA_SASL_USERNAME`	The username for Kafka SASL authentication.
`KAFKA_SASL_PASSWORD`	The password for Kafka SASL authentication.
`KAFKA_ENABLE_SSL`	Set to `true` to enable SSL/TLS for Kafka connections.	`false`
`KAFKA_REJECT_UNAUTHORIZED`	Set to `false` to allow untrusted SSL certificates. Not recommended for production.	`true`
`KAFKA_CUSTOM_SSL`	Set to `true` to supply custom SSL certificate files via the variables below.	`false`
`KAFKA_CA_FILE`	Path to the CA certificate file. Required when `KAFKA_CUSTOM_SSL` is `true`.
`KAFKA_CERT_FILE`	Path to the client certificate file.
`KAFKA_KEY_FILE`	Path to the client key file.
`KAFKA_MAX_RETRIES`	The maximum number of reconnection attempts before giving up.	`3`

​Server

​Core

​Database

​Authentication

​Model Server

​Conversation Management

​Voice

​Observability

​Advanced

​Event Ingestion

​Kafka