Skip to content

Umgebungsvariablen

Diese Seite listet alle Umgebungsvariablen auf, die vom Swiss AI Hub Deployment gelesen werden, gruppiert nach ihrer Rolle. Sie wird automatisch aus den Pydantic-Settings-Klassen in packages/*/swiss_ai_hub/**/*settings.py und den Docker-Compose-Templates generiert. Bearbeiten Sie sie nicht manuell – führen Sie make generate-env-docs aus, um sie zu aktualisieren.

Variablen fallen in drei Kategorien:

  • Compose-erforderlich — referenziert als ${VAR} in docker-compose.yml. Muss in .env gesetzt werden, da die Compose-Templates des Projekts keine Fallback-Standardwerte bereitstellen.
  • App-erforderlich — wird als Pflichtfeld von einer Pydantic BaseSettings-Klasse gelesen. Die Anwendung startet nicht, wenn es nicht gesetzt ist.
  • Optional — hat einen Standardwert im Code. Nur in .env setzen, um den Standardwert zu überschreiben.

Das Deployment hat eine Basisvariante (CPU) sowie reine Erweiterungsvarianten (GPU). Der erste Abschnitt unten listet alle für die Basis erforderlichen Variablen auf; nachfolgende Abschnitte listen nur die zusätzlichen Variablen auf, die jede Erweiterung über die Basis hinaus einführt.

Variablen für das Basis-Deployment (CPU)

Erforderlich für die Docker-Compose-Interpolation

Diese Variablen werden als ${VAR} (ohne einen ${VAR:-default} Fallback) irgendwo in docker-compose.yml referenziert. Das Compose-Parsing schlägt fehl oder rendert leere Werte, wenn .env sie nicht definiert. Die Spalte "Consumer" zeigt das Pydantic-Settings-Feld an, das die Variable liest, wenn unser Python-Code sie konsumiert; andernfalls verweist sie auf die Konfigurationsdatei, die sie einbettet (Keycloak-Realm-Import, Identity-Provider-Konfiguration usw.) oder – falls keines davon zutrifft – bleibt sie leer. Die Spalte "Service(s)" listet die Compose-Services auf, deren environment:-Block die Variable empfängt.

VariableConsumerService(s)Description
ACME_EMAILtraefik
ADMIN_EMAILopen-webui
ADMIN_PASSWORD_HASHtraefik
AIHUB_CREATE_DEFAULT_BUCKETSAIHubSettings.CREATE_DEFAULT_BUCKETSapi, seaweedfs-initErstellt Standard-Wissens-Buckets und -Namespaces
AIHUB_DEFAULT_BUCKET_NAMEAIHubSettings.DEFAULT_BUCKET_NAMEapi, default_rag_pipeline, seaweedfs-initName des Standard-Wissens-Buckets
AIHUB_DEFAULT_NAMESPACE_NAMEAIHubSettings.DEFAULT_NAMESPACE_NAMEapiName des Standard-Namespaces
AIHUB_SHARED_BUCKET_NAMEAIHubSettings.SHARED_BUCKET_NAMEapi, seaweedfs-init, shared_rag_pipelineName des geteilten Wissens-Buckets
AIHUB_SHARED_NAMESPACE_NAMEAIHubSettings.SHARED_NAMESPACE_NAMEapiName des geteilten Namespaces
AIHUB_STARTUP_TENANT_ACCESS_RULESStartupTenantSettings.ACCESS_RULESapiKomma-getrennte Zugriffsregeln für den Startup-Mandanten. Verwenden Sie 'aihub.admin.>' für uneingeschränkten Zugriff auf alle Plattformfunktionen.
AIHUB_STARTUP_TENANT_DESCRIPTIONStartupTenantSettings.DESCRIPTIONapiBeschreibung des Startup-Mandanten.
AIHUB_STARTUP_TENANT_IDStartupTenantSettings.IDapi, keycloakEindeutiger Identifikator für den Startup-Mandanten. Wird auch als Keycloak-Gruppenname verwendet.
AIHUB_STARTUP_TENANT_NAMEStartupTenantSettings.NAMEapiAnzeigename des Startup-Mandanten.
AIHUB_USER_SIGNUP_FIRST_ADMIN_USER_ROLESUserSignupSettings.FIRST_ADMIN_USER_ROLESapiKomma-getrennte Liste der Rollen, die dem allerersten Benutzer zugewiesen werden. Dieser Benutzer ist typischerweise der anfängliche Plattformadministrator.
AIHUB_USER_SIGNUP_REGULAR_USER_ROLESUserSignupSettings.REGULAR_USER_ROLESapiKomma-getrennte Liste der Rollen, die regulären Benutzern (nicht dem ersten Benutzer) zugewiesen werden. Diese Benutzer haben typischerweise Standardzugriff auf die Plattform.
AIHUB_VERSIONAIHubSettings.VERSIONapi, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-apiVersion der App
AUTH_OPEN_WEBUI_SIGNING_SECRETAuthSettings.OPEN_WEBUI_SIGNING_SECRETapi, open-webui, sysadmin-apiOpenWebUI Signatur-Secret
BACKUP_MINIMUM_KEEPBackupSettings.MINIMUM_KEEPbackup-code
BACKUP_POSTGRES_SUBPROCESS_TIMEOUT_SECONDSBackupSettings.POSTGRES_SUBPROCESS_TIMEOUT_SECONDSbackup-code
BACKUP_RETENTION_DAYSBackupSettings.RETENTION_DAYSbackup-code
BACKUP_S3_BUCKETBackupSettings.S3_BUCKETbackup-code
DAGSTER_CLEANUP_BATCH_LIMITbackup-code
DAGSTER_DBbackup-code
DAGSTER_DEBUG_LOG_RETENTION_DAYSbackup-code
DAGSTER_INFO_LOG_RETENTION_DAYSbackup-code
DAGSTER_UNIMPORTANT_EVENT_RETENTION_DAYSbackup-code
DAGSTER_WARNING_LOG_RETENTION_DAYSbackup-code
DOMAIN30-clients.json, realm-settings.jsonapi, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, keycloak, keycloak-config, langfuse-web, litellm, llm_wrapping_agent, namespace_selection_agent, oauth2proxy-attu, oauth2proxy-backup, oauth2proxy-dagster, oauth2proxy-seaweed, open-webui, rag_agent, retrieval_agent, seaweedfs-s3, shared_rag_pipeline, sysadmin-api, sysadmin-web, traefik, web
ENVapi, open-webui, sysadmin-api
ETCD_TOKENetcd, etcd-init, milvus-standalone, seaweedfs-filer
EXPERT_ASKING_CHANNEL_TYPEexpert_asking_agent
GEMINI_API_KEYlitellm
HUGGINGFACE_API_KEYlitellm, vllm, vllm-bge-m3, vllm-bge-reranker
JUPYTER_TOKENapi, jupyter, open-webui
KEYCLOAK_ADMIN_PASSWORDkeycloak, keycloak-config
KEYCLOAK_ADMIN_USERkeycloak, keycloak-config
KEYCLOAK_API_SERVICE_CLIENT_SECRETKeycloakSettings.API_SERVICE_CLIENT_SECRETapi, bot, keycloak, keycloak-config, sysadmin-apiClient Secret für das API-Service-Konto
KEYCLOAK_AZURE_CLIENT_IDidentity-providers.jsonkeycloak, keycloak-config
KEYCLOAK_AZURE_CLIENT_SECRETidentity-providers.jsonkeycloak, keycloak-config
KEYCLOAK_AZURE_TENANT_IDidentity-providers.jsonkeycloak, keycloak-config
KEYCLOAK_OAUTH2_PROXY_ATTU_SECRET30-clients.jsonkeycloak, keycloak-config, oauth2proxy-attu
KEYCLOAK_OAUTH2_PROXY_BACKUP_SECRET30-clients.jsonkeycloak, keycloak-config, oauth2proxy-backup
KEYCLOAK_OAUTH2_PROXY_DAGSTER_SECRET30-clients.jsonkeycloak, keycloak-config, oauth2proxy-dagster
KEYCLOAK_OAUTH2_PROXY_DATALAKE_SECRET30-clients.jsonkeycloak, keycloak-config, oauth2proxy-seaweed
KEYCLOAK_OPENWEBUI_CLIENT_SECRET30-clients.jsonkeycloak, keycloak-config, open-webui
KEYCLOAK_SHOW_KEYCLOAK_LOGINKeycloakSettings.SHOW_KEYCLOAK_LOGINapi, sysadmin-apiZeigt einen direkten Keycloak-Login-Button neben föderierten IDPs an
LANGFUSE_ALLOWED_ORGANIZATION_CREATORSlangfuse-web
LANGFUSE_CLICKHOUSE_PASSWORDbackup-code, clickhouse, langfuse-web, langfuse-worker
LANGFUSE_ENCRYPTION_KEYlangfuse-web, langfuse-worker
LANGFUSE_INIT_USER_EMAILlangfuse-web
LANGFUSE_INIT_USER_PASSWORDlangfuse-web
LANGFUSE_KEYCLOAK_CLIENT_SECRETkeycloak, keycloak-config, langfuse-web
LANGFUSE_NEXTAUTH_SECRETlangfuse-web
LANGFUSE_PUBLIC_KEYLangfuseSettings.PUBLIC_KEYapi, langfuse-web, otel-collectorLangfuse öffentlicher API-Schlüssel
LANGFUSE_SALTlangfuse-web, langfuse-worker
LANGFUSE_SECRET_KEYLangfuseSettings.SECRET_KEYapi, langfuse-web, otel-collectorLangfuse privater API-Schlüssel
LITELLM_MASTER_KEYlitellm-config.ymlapi, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, litellm, llm_wrapping_agent, mineru-api, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipeline
LITELLM_UI_PASSWORDlitellm
LITELLM_UI_USERNAMElitellm
LOCAL_LLM_TOKENlitellm-config.ymllitellm, vllm, vllm-bge-m3, vllm-bge-reranker
LOG_LEVELLogSettings.LEVELapi, bot, dagster-daemon, dagster-webserver, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-api, traefikLogging-Level
MAINTENANCE_DISABLEDbackup-code
MEM0_EMBEDDING_MODEL_NAMEMem0Settings.EMBEDDING_MODEL_NAMEapi, bot, llm_wrapping_agent, rag_agent, shared_rag_pipelineName des zu verwendenden Embedding-Modells
MEM0_LLM_NAMEMem0Settings.LLM_NAMEapi, bot, llm_wrapping_agent, rag_agent, shared_rag_pipelineName des zu verwendenden LLM
MEM0_RERANKING_MODEL_NAMEMem0Settings.RERANKING_MODEL_NAMEapi, bot, llm_wrapping_agent, rag_agent, shared_rag_pipelineName des zu verwendenden Reranking-Modells
MILVUS_DIMENSIONMilvusSettings.DIMENSIONapi, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipelineDimension des Embedding-Vektors
MILVUS_ROOT_PASSWORDMilvusSettings.ROOT_PASSWORDapi, attu, backup-code, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, milvus-standalone, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, shared_rag_pipelineRoot-Passwort für die Milvus-Authentifizierung. Falls nicht gesetzt, wird keine Authentifizierung verwendet. Der Benutzername ist immer 'root'.
MINERU_API_MAX_CONCURRENT_REQUESTSmineru-api
MINERU_API_TIMEOUTMineruSettings.API_TIMEOUTapi, default_rag_pipeline, shared_rag_pipelineTimeout für MinerU API-Aufrufe in Sekunden
MINERU_FORMULA_ENABLEMineruSettings.FORMULA_ENABLEapi, default_rag_pipeline, shared_rag_pipelineFormel-/Gleichungs-Parsing aktivieren
MINERU_TABLE_ENABLEMineruSettings.TABLE_ENABLEapi, default_rag_pipeline, shared_rag_pipelineTabellenerkennung und -Parsing aktivieren
MINERU_VLM_NAMEMineruSettings.VLM_NAMEapi, default_rag_pipeline, mineru-api, shared_rag_pipelineLiteLLM Modell-Alias für MinerU VLM
MONGO_PASSWORDapi, backup-code, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, ferretdb, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, postgres-ferretdb, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-api
MONGO_USERNAMEapi, backup-code, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, ferretdb, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, postgres-ferretdb, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-api
NATS_TOKENNatsSettings.TOKENapi, backup-code, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, nats, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-apiAuthentifizierungs-Token für den NATS-Server. Falls nicht gesetzt, wird keine Authentifizierung verwendet.
NEO4J_PASSWORDNeo4jSettings.PASSWORDapi, bot, llm_wrapping_agent, neo4j, rag_agent, shared_rag_pipelinePasswort für den Neo4j DB Server
NEO4J_USERNAMENeo4jSettings.USERNAMEapi, bot, llm_wrapping_agent, neo4j, rag_agent, shared_rag_pipelineBenutzername für den Neo4j DB Server
NOTIFICATION_URLSNotificationSettings.URLSdefault_rag_pipeline, shared_rag_pipelineApprise-Benachrichtigungs-URIs (komma-getrennt). Beispiele: 'slack://TokenA/TokenB/TokenC/#alerts', 'mailto://user:pw@smtp.example.com', 'discord://webhook_id/webhook_token'. Eine vollständige Liste finden Sie unter https://github.com/caronc/apprise.
OAUTH_ADMIN_ROLES_OPENWEBUIopen-webui
OAUTH_ALLOWED_GROUPS_ATTUoauth2proxy-attu
OAUTH_ALLOWED_GROUPS_BACKUPoauth2proxy-backup
OAUTH_ALLOWED_GROUPS_DAGSTERoauth2proxy-dagster
OAUTH_ALLOWED_GROUPS_SEAWEEDFSoauth2proxy-seaweed
OAUTH_CLIENT_IDapi, bot, open-webui, sysadmin-api, sysadmin-web, web
OAUTH_CLIENT_SECRETapi, bot, open-webui, sysadmin-api
OAUTH_COOKIE_SECRET_ATTUoauth2proxy-attu
OAUTH_COOKIE_SECRET_BACKUPoauth2proxy-backup
OAUTH_COOKIE_SECRET_DAGSTERoauth2proxy-dagster
OAUTH_COOKIE_SECRET_SEAWEEDFSoauth2proxy-seaweed
OAUTH_CUSTOM_SIGN_IN_LOGOoauth2proxy-attu, oauth2proxy-backup, oauth2proxy-dagster, oauth2proxy-seaweed
OAUTH_TENANT_IDapi, sysadmin-api
OPENWEBUI_SCIM_TOKENOpenWebuiSettings.SCIM_TOKENapi, open-webui, sysadmin-apiSCIM 2.0 Bearer-Token für die Gruppen- und Benutzerbereitstellung
OPENWEBUI_SECRET_KEYOpenWebuiSettings.SECRET_KEYapi, open-webui, sysadmin-apiOpenWebUI WEBUI_SECRET_KEY für die JWT-Signatur
OPENWEBUI_SERVICE_ACCOUNT_IDOpenWebuiSettings.SERVICE_ACCOUNT_IDapi, openwebui-init, sysadmin-apiUUID des AI-Hub Service-Kontos in der OpenWebUI-Datenbank
OPENWEBUI_WEBHOOK_SECRETOpenWebuiSettings.WEBHOOK_SECRETapi, open-webui, sysadmin-apiGeteiltes Secret zur Authentifizierung von OpenWebUI Webhook-Aufrufen
OTEL_CLOUD_ENDPOINTotel-config.ymlotel-collector
OTEL_CLOUD_HEADERSotel-config.ymlotel-collector
OTEL_ENABLEDOpenTelemetrySettings.ENABLEDapi, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, sysadmin-apiOpenTelemetry-Tracing vollständig aktivieren/deaktivieren
POSTGRES_PASSWORDopenwebui-init-openwebui.shbackup-code, dagster-daemon, dagster-webserver, default_rag_pipeline, keycloak, langfuse-web, langfuse-worker, litellm, open-webui, openwebui-init, pgbouncer, postgres, postgres-ferretdb, shared_rag_pipeline
POSTGRES_PORTopenwebui-init-openwebui.shbackup-code, openwebui-init
POSTGRES_USERopenwebui-init-openwebui.shbackup-code, dagster-daemon, dagster-webserver, default_rag_pipeline, keycloak, langfuse-web, langfuse-worker, litellm, open-webui, openwebui-init, pgbouncer, postgres, postgres-ferretdb, shared_rag_pipeline
RCLONE_RC_PASSRcloneSettings.RC_PASSrcloneRC API-Passwort für die Authentifizierung.
RCLONE_RC_USERRcloneSettings.RC_USERrcloneRC API-Benutzername für die Authentifizierung.
REDIS_TOKENRedisSettings.TOKENapi, backup-code, expert_asking_agent, expert_rag_agent, few_shot_agent, langfuse-web, langfuse-worker, litellm, llm_wrapping_agent, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, sysadmin-api, valkeyAuthentifizierungs-Token für den Redis-Server. Falls nicht gesetzt, wird keine Authentifizierung verwendet.
S3_STORAGE_ACCESS_KEYS3StorageSettings.ACCESS_KEYapi, backup-code, clickhouse, default_rag_pipeline, expert_rag_agent, langfuse-web, langfuse-worker, milvus-standalone, open-webui, rag_agent, retrieval_agent, seaweedfs-init, seaweedfs-s3, shared_rag_pipelineDer Access Key für den S3-Endpoint.
S3_STORAGE_SECRET_KEYS3StorageSettings.SECRET_KEYapi, backup-code, clickhouse, default_rag_pipeline, expert_rag_agent, langfuse-web, langfuse-worker, milvus-standalone, open-webui, rag_agent, retrieval_agent, seaweedfs-init, seaweedfs-s3, shared_rag_pipelineDer Secret Key für den S3-Endpoint.
SEARXNG_SECRET_KEYsearxng
SEAWEEDFS_TOKENseaweedfs-filer, seaweedfs-master, seaweedfs-s3, seaweedfs-volume
SLACK_CHANNEL_IDexpert_asking_agent
SLACK_SERVICE_URLexpert_asking_agent
SUPERUSER_EMAILSuperuserSettings.EMAILapi, keycloak, sysadmin-apiKeycloak-E-Mail, die zur Suche des Superusers verwendet wird.
SUPERUSER_FIRSTNAMEusers-superuser.jsonkeycloak
SUPERUSER_LASTNAMEusers-superuser.jsonkeycloak
SUPERUSER_PASSWORDusers-superuser.jsonkeycloak
SUPERUSER_ROLES_JSONSuperuserSettings.ROLES_JSONapi, keycloak, sysadmin-apiJSON-Array von Realm-Rollen, die dem Superuser zugewiesen sind und unverändert über dieselbe Umgebungsvariable mit dem Keycloak-Realm-Import geteilt werden. Muss AIHubSysAdmin enthalten.
SUPERUSER_TOKENSuperuserSettings.TOKENapi, open-webui, sysadmin-apiStatisches Bearer-Token für Maschine-zu-Maschine-API-Aufrufe. Muss mit 'sk-' beginnen.
SUPERUSER_USERNAMESuperuserSettings.USERNAMEapi, keycloak, sysadmin-apiKeycloak-Benutzername des initialisierten Superusers.
SWISS_LLM_CLOUD_API_BASE_URLlitellm-config.ymllitellm
SWISS_LLM_CLOUD_API_KEYlitellm-config.ymllitellm
SWISS_LLM_CLOUD_EMBEDDING_API_BASE_URLlitellm-config.ymllitellm
SWISS_LLM_CLOUD_EMBEDDING_API_KEYlitellm-config.ymllitellm
SWISS_LLM_CLOUD_OCR_API_BASE_URLlitellm-config.ymllitellm
SWISS_LLM_CLOUD_OCR_API_KEYlitellm-config.ymllitellm
SWISS_LLM_CLOUD_RERANKING_API_BASE_URLlitellm-config.ymllitellm
SWISS_LLM_CLOUD_RERANKING_API_KEYlitellm-config.ymllitellm
SWISS_LLM_CLOUD_WHISPER_API_BASE_URLlitellm-config.ymllitellm
SWISS_LLM_CLOUD_WHISPER_API_KEYlitellm-config.ymllitellm
TEAMS_BOT_IDexpert_asking_agent
TEAMS_CHANNEL_IDexpert_asking_agent
TEAMS_TENANT_IDexpert_asking_agent

Erforderlich durch SDK-Settings-Klassen (nicht vom Standard-Deployment verwendet)

Diese Variablen sind als Pflichtfelder in einer Pydantic BaseSettings-Klasse deklariert und werden nicht von einem Service im Standard-Docker-Compose-Stack konsumiert. Die leere Spalte "Service(s)" spiegelt dies wider: Kein Container im Standard-Deployment lädt die Settings-Klasse. Sie werden erst dann operativ erforderlich, wenn ein benutzerdefinierter Agent, eine Pipeline oder eine andere Erweiterung zu Docker-Compose hinzugefügt wird, die die entsprechende SDK-Funktionalität aktiviert (z.B. der SharePoint-Konnektor oder der Azure Document Intelligence Loader). Bis dahin ist es in Ordnung, die Platzhalter unverändert zu lassen – Pydantic validiert die Klasse nur, wenn sie instanziiert wird.

VariableConsumerService(s)Description
AZURE_DATA_LAKE_CONNECTION_STRINGAzureDataLakeSettings.CONNECTION_STRINGAzure Data Lake Connection String für explizite Authentifizierung. Empfohlen gegenüber impliziter Authentifizierung.
AZURE_DOCUMENT_INTELLIGENCE_API_KEYAzureDocumentIntelligenceSettings.API_KEYAPI-Schlüssel für Document Intelligence
AZURE_DOCUMENT_INTELLIGENCE_ENDPOINTAzureDocumentIntelligenceSettings.ENDPOINT
SHAREPOINT_CLIENT_IDSharePointSettings.CLIENT_IDDie Anwendungs- (Client-) ID.
SHAREPOINT_CLIENT_SECRETSharePointSettings.CLIENT_SECRETDas Client Secret für die Authentifizierung.
SHAREPOINT_SITE_URLSharePointSettings.SITE_URLDie SharePoint-Site-URL.
SHAREPOINT_TENANT_IDSharePointSettings.TENANT_IDDie Azure AD Tenant ID.

Optional: Plattform-Standardwerte überschreiben

Diese Variablen haben sinnvolle Standardwerte (oder werden Containern über Docker-Compose bereitgestellt) und müssen nicht in .env gesetzt werden. Fügen Sie sie nur hinzu, um den Standardwert zu überschreiben. Variablen, die mit (supplied by compose) gekennzeichnet sind, werden von der Anwendung benötigt, erhalten ihren Wert jedoch über docker-compose.yml injiziert, sodass das Setzen in .env keine Auswirkung hat.

VariableConsumerDefaultService(s)Description
AIHUB_API_DEBUG_MODEAIHubSettings.API_DEBUG_MODEFalseDebug-Modus für die Entwicklung
AIHUB_CREATE_DEFAULT_ROLESAIHubSettings.CREATE_DEFAULT_ROLESTrueapi, sysadmin-apiErstellt Standard-Rollen wie AI-Hub Admin und AI-Hub User
AIHUB_FRONTEND_ORIGINAIHubSettings.FRONTEND_ORIGIN(supplied by compose)api, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-apiKomma-getrennte Liste von Ursprüngen, für die CORS erlaubt ist
AIHUB_MONGO_MAIN_DB_NAMEAIHubSettings.MONGO_MAIN_DB_NAME'aihub'Name der MongoDB-Datenbank, die zum Speichern von Daten verwendet wird
AIHUB_OPENAI_API_BASE_URLAIHubSettings.OPENAI_API_BASE_URL'http://api:8000/api/v1/active/openai'apiBasis-URL des OpenAI-kompatiblen Endpunkts von AI-Hub, verwendet für die Langfuse LLM-Verbindung
AUTH_ENABLE_API_ACCESSAuthSettings.ENABLE_API_ACCESSTrueapi, sysadmin-apiAPI-Zugriff aktivieren
AZURE_DOCUMENT_INTELLIGENCE_API_VERSIONAzureDocumentIntelligenceSettings.API_VERSION'2024-11-30'
AZURE_DOCUMENT_INTELLIGENCE_EXTENSIONSAzureDocumentIntelligenceSettings.EXTENSIONS['pdf', 'docx', 'xlsx', 'pptx', 'html']Unterstützte Dateierweiterungen für die Dokumentenverarbeitung
BACKUP_AWS_ENDPOINT_URLBackupSettings.AWS_ENDPOINT_URL'http://seaweedfs-s3:9000'backup-code
BACKUP_CLICKHOUSE_HOSTBackupSettings.CLICKHOUSE_HOST'clickhouse'backup-code
BACKUP_CLICKHOUSE_PORTBackupSettings.CLICKHOUSE_PORT8123
BACKUP_CLICKHOUSE_USERBackupSettings.CLICKHOUSE_USER'clickhouse'backup-code
BACKUP_DAGSTER_CLEANUP_BATCH_LIMITBackupSettings.DAGSTER_CLEANUP_BATCH_LIMIT1000000backup-code
BACKUP_DAGSTER_DBBackupSettings.DAGSTER_DB'dagster'backup-code
BACKUP_DAGSTER_DEBUG_LOG_RETENTION_DAYSBackupSettings.DAGSTER_DEBUG_LOG_RETENTION_DAYS7backup-code
BACKUP_DAGSTER_INFO_LOG_RETENTION_DAYSBackupSettings.DAGSTER_INFO_LOG_RETENTION_DAYS60backup-code
BACKUP_DAGSTER_UNIMPORTANT_EVENT_RETENTION_DAYSBackupSettings.DAGSTER_UNIMPORTANT_EVENT_RETENTION_DAYS30backup-code
BACKUP_DAGSTER_WARNING_LOG_RETENTION_DAYSBackupSettings.DAGSTER_WARNING_LOG_RETENTION_DAYS60backup-code
BACKUP_LANGFUSE_CLICKHOUSE_PASSWORDBackupSettings.LANGFUSE_CLICKHOUSE_PASSWORD(supplied by compose)backup-code
BACKUP_MAINTENANCE_DISABLEDBackupSettings.MAINTENANCE_DISABLEDFalsebackup-code
BACKUP_MILVUS_HOSTBackupSettings.MILVUS_HOST'milvus-standalone'backup-code
BACKUP_MILVUS_PORTBackupSettings.MILVUS_PORT19530backup-code
BACKUP_MILVUS_ROOT_PASSWORDBackupSettings.MILVUS_ROOT_PASSWORD(supplied by compose)backup-code
BACKUP_MONGO_PASSWORDBackupSettings.MONGO_PASSWORD(supplied by compose)backup-code
BACKUP_MONGO_USERNAMEBackupSettings.MONGO_USERNAME'admin'backup-code
BACKUP_NATS_TOKENBackupSettings.NATS_TOKEN(supplied by compose)backup-code
BACKUP_NATS_URLBackupSettings.NATS_URL'nats://nats:4222'backup-code
BACKUP_NEO4J_CONTAINERBackupSettings.NEO4J_CONTAINER'neo4j'backup-code
BACKUP_POSTGRES_FERRETDB_HOSTBackupSettings.POSTGRES_FERRETDB_HOST'postgres-ferretdb'backup-code
BACKUP_POSTGRES_HOSTBackupSettings.POSTGRES_HOST'postgres'backup-code
BACKUP_POSTGRES_PASSWORDBackupSettings.POSTGRES_PASSWORD(supplied by compose)backup-code
BACKUP_POSTGRES_PORTBackupSettings.POSTGRES_PORT5432backup-code
BACKUP_POSTGRES_USERBackupSettings.POSTGRES_USER'admin'backup-code
BACKUP_REDIS_TOKENBackupSettings.REDIS_TOKEN(supplied by compose)backup-code
BACKUP_S3_STORAGE_ACCESS_KEYBackupSettings.S3_STORAGE_ACCESS_KEY'admin'backup-code
BACKUP_S3_STORAGE_SECRET_KEYBackupSettings.S3_STORAGE_SECRET_KEY(supplied by compose)backup-code
BACKUP_VALKEY_CONTAINERBackupSettings.VALKEY_CONTAINER'valkey'backup-code
BACKUP_VALKEY_HOSTBackupSettings.VALKEY_HOST'valkey'
BACKUP_VALKEY_PORTBackupSettings.VALKEY_PORT6379
KEYCLOAK_API_SERVICE_CLIENT_IDKeycloakSettings.API_SERVICE_CLIENT_ID'aihub-api-service'Client-ID für das API-Service-Konto
KEYCLOAK_EXTERNAL_URLKeycloakSettings.EXTERNAL_URLNoneapi, bot, sysadmin-apiExterne Keycloak-URL, wie sie von Browsern gesehen wird, verwendet für die Issuer-Validierung
KEYCLOAK_REALMKeycloakSettings.REALM'aihub'api, bot, sysadmin-apiKeycloak Realm-Name
KEYCLOAK_URLKeycloakSettings.URL(supplied by compose)api, bot, keycloak-config, sysadmin-apiInterne Keycloak-URL für direkten Zugriff (z.B. http://keycloak:8080)
LANGFUSE_BASE_URLLangfuseSettings.BASE_URL(supplied by compose)apiLangfuse Server-Basis-URL
LANGFUSE_PROJECT_IDLangfuseSettings.PROJECT_IDNoneapiLangfuse Projekt-ID zum Erstellen von Dataset-URLs
LANGFUSE_PUBLIC_URLLangfuseSettings.PUBLIC_URLNoneapiÖffentlich zugängliche Langfuse-URL für Browser-Links (z.B. https://langfuse.example.com)
LANGFUSE_TIMEOUTLangfuseSettings.TIMEOUT60Timeout in Sekunden für Langfuse API-Anfragen
LITE_LLM_PROXY_API_KEYLiteLLMProxySettings.API_KEYNoneapi, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipelineAPI-Schlüssel für die Authentifizierung. Falls nicht angegeben, werden andere Authentifizierungsmethoden verwendet.
LITE_LLM_PROXY_BASE_URLLiteLLMProxySettings.BASE_URL(supplied by compose)api, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipelineDie Basis-URL des Modells.
LITE_LLM_PROXY_USER_BUDGET_DURATIONLiteLLMProxySettings.USER_BUDGET_DURATIONNoneDas Budget wird am Ende der angegebenen Dauer zurückgesetzt. Falls nicht gesetzt, wird das Budget niemals zurückgesetzt. Sie können die Dauer in Sekunden ("30s"), Minuten ("30m"), Stunden ("30h"), Tagen ("30d"), Monaten ("1mo") festlegen.
LITE_LLM_PROXY_USER_MAX_BUDGETLiteLLMProxySettings.USER_MAX_BUDGETNoneBudget, das einem Benutzer in einem Zeitraum zur Verfügung steht
LITE_LLM_PROXY_USER_MAX_PARALLEL_REQUESTSLiteLLMProxySettings.USER_MAX_PARALLEL_REQUESTSNoneBegrenzt die Anzahl der parallelen Anfragen eines Benutzers. Löst einen 429-Fehler aus, wenn die parallelen Anfragen des Benutzers > x sind.
LITE_LLM_PROXY_USER_RPM_LIMITLiteLLMProxySettings.USER_RPM_LIMITNoneLegt das RPM-Limit für einen bestimmten Benutzer fest (Anfragen pro Minute)
LITE_LLM_PROXY_USER_SOFT_BUDGETLiteLLMProxySettings.USER_SOFT_BUDGETNoneErhält Warnungen, wenn der Benutzer das angegebene Budget überschreitet; blockiert jedoch keine Anfragen.
LITE_LLM_PROXY_USER_TPM_LIMITLiteLLMProxySettings.USER_TPM_LIMITNoneLegt das TPM-Limit für einen bestimmten Benutzer fest (Tokens pro Minute)
MEM0_SUPPORT_VISIONMem0Settings.SUPPORT_VISIONTrueOb Vision unterstützt werden soll
MEM0_VISION_DETAILMem0Settings.VISION_DETAIL'auto'Vision-Details
MEMORY_DEFAULT_TENANT_IDMemorySettings.DEFAULT_TENANT_ID'AIHub'Standard-Mandanten-ID für den Speicher-Scope
MEMORY_DEFAULT_TENANT_NAMESPACEMemorySettings.DEFAULT_TENANT_NAMESPACENoneStandard-Mandanten-Namespace für den Bereich auf Abteilungsebene
MILVUS_URLMilvusSettings.URL(supplied by compose)api, attu, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipelineVerbindungs-URL für den Milvus DB Server
MINERU_API_BASE_URLMineruSettings.API_BASE_URL'http://mineru-api:8000'api, default_rag_pipeline, shared_rag_pipelineMinerU API Endpunkt-URL
MINERU_EXTENSIONSMineruSettings.EXTENSIONS['pdf', 'png', 'jpeg', 'jp2', 'webp', 'gif', 'bmp', 'jpg', 'tiff']Von MinerU unterstützte Dateierweiterungen
MINERU_VLM_SERVER_API_KEYMineruSettings.VLM_SERVER_API_KEYSecretStr('')api, default_rag_pipeline, shared_rag_pipelineLiteLLM API-Schlüssel für VLM-Anfragen
MINERU_VLM_SERVER_URLMineruSettings.VLM_SERVER_URL'http://litellm:4000'api, default_rag_pipeline, shared_rag_pipelineLiteLLM Proxy-URL für VLM-Routing
MONGO_CONNECTION_STRINGMongoSettings.CONNECTION_STRING(supplied by compose)api, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-apiÜberschreibt den MongoDB Connection String
NATS_ENDPOINTNatsSettings.ENDPOINT(supplied by compose)api, bot, default_rag_pipeline, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, shared_rag_pipeline, sysadmin-apiVerbindungs-Endpunkt für das NATS Messaging-System
NEO4J_URLNeo4jSettings.URL(supplied by compose)api, bot, llm_wrapping_agent, rag_agent, shared_rag_pipelineVerbindungs-URL für den Neo4j DB Server
NOTIFICATION_DAGSTER_UI_BASE_URLNotificationSettings.DAGSTER_UI_BASE_URLNonedefault_rag_pipeline, shared_rag_pipelineBasis-URL der Dagster-UI, die zum Erstellen von Deep Links in Benachrichtigungstexten verwendet wird (z.B. 'https://dagster.example.com').
NOTIFICATION_MIN_INTERVAL_SECONDSNotificationSettings.MIN_INTERVAL_SECONDS30default_rag_pipeline, shared_rag_pipelineMinimales Intervall zwischen Sensor-Ticks in Sekunden.
NOTIFICATION_TITLE_PREFIXNotificationSettings.TITLE_PREFIX'Swiss AI Hub Pipeline'default_rag_pipeline, shared_rag_pipelinePräfix, das dem Benachrichtigungstitel vorangestellt wird.
OPENWEBUI_BASE_URLOpenWebuiSettings.BASE_URL(supplied by compose)api, sysadmin-apiOpenWebUI Server-Basis-URL
OTEL_EXPORTER_OTLP_ENDPOINTOpenTelemetrySettings.EXPORTER_OTLP_ENDPOINTNoneapi, expert_asking_agent, expert_rag_agent, few_shot_agent, litellm, llm_wrapping_agent, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, sysadmin-apiOTLP Exporter Endpunkt-URL
OTEL_EXPORTER_OTLP_INSECUREOpenTelemetrySettings.EXPORTER_OTLP_INSECURETrueopen-webuiUnsichere Verbindung (kein TLS) für gRPC verwenden
OTEL_EXPORTER_OTLP_PROTOCOLOpenTelemetrySettings.EXPORTER_OTLP_PROTOCOL'grpc'api, expert_asking_agent, expert_rag_agent, few_shot_agent, litellm, llm_wrapping_agent, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, sysadmin-apiOTLP-Protokoll
OTEL_RESOURCE_SERVICE_NAMEOpenTelemetrySettings.RESOURCE_SERVICE_NAMENoneapi, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, sysadmin-apiRessource Service-Name
OTEL_RESOURCE_SERVICE_NAMESPACEOpenTelemetrySettings.RESOURCE_SERVICE_NAMESPACENoneapi, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, sysadmin-apiRessource Service-Namespace
OTEL_RESOURCE_SERVICE_VERSIONOpenTelemetrySettings.RESOURCE_SERVICE_VERSIONNoneapi, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, rag_agent, retrieval_agent, sysadmin-apiRessource Service-Version
PARSING_PASSTHROUGH_EXTENSIONSParsingSettings.PASSTHROUGH_EXTENSIONS[]Dateierweiterungen, die leeren Inhalt anstelle von 400 zurückgeben (z.B. für die agentenbasierte Verarbeitung). Über die Umgebungsvariable als JSON-Array festlegen: PARSING_PASSTHROUGH_EXTENSIONS='["zip","wav"]'
RCLONE_URLRcloneSettings.URL'http://rclone:5572'Rclone RC API URL (z.B. http://rclone:5572).
REDIS_URLRedisSettings.URL(supplied by compose)api, expert_asking_agent, expert_rag_agent, few_shot_agent, llm_wrapping_agent, namespace_selection_agent, open-webui, rag_agent, retrieval_agent, sysadmin-apiVerbindungs-URL für den Redis-Server (ohne Token)
S3_STORAGE_ENDPOINTS3StorageSettings.ENDPOINT(supplied by compose)api, default_rag_pipeline, expert_rag_agent, rag_agent, retrieval_agent, shared_rag_pipelineDer S3-Endpunkt von AWS oder Minio.
S3_STORAGE_PUBLIC_ENDPOINTS3StorageSettings.PUBLIC_ENDPOINTNoneapi, default_rag_pipeline, expert_rag_agent, rag_agent, retrieval_agent, shared_rag_pipelineDer öffentlich zugängliche S3-Endpunkt für vorab signierte URLs. Falls nicht gesetzt, wird auf ENDPOINT zurückgegriffen. Verwenden Sie dies, wenn interne und externe Endpunkte sich unterscheiden (z.B. Docker intern vs. Traefik-geroutet extern).
S3_STORAGE_REGIONS3StorageSettings.REGION'us-east-1'Die Region für den S3-Endpunkt. Für Minio ist der Wert irrelevant.
S3_STORAGE_URL_SIGNING_SECRETS3StorageSettings.URL_SIGNING_SECRET(supplied by compose)api, default_rag_pipeline, expert_rag_agent, rag_agent, retrieval_agent, shared_rag_pipelineEin geheimer Schlüssel, der zum Signieren und Verifizieren temporärer anonymer Zugriffs-URLs verwendet wird.
USAGE_LIMIT_WARNING_THRESHOLD_PERCENTUsageLimitSettings.WARNING_THRESHOLD_PERCENT80Nutzungs-Prozentsatz, bei dem Warn-Header ausgegeben werden

Zusätzliche Variablen für GPU-Deployments

Die GPU-Variante führt derzeit keine zusätzlichen, vom Operator gesteuerten Variablen über den oben genannten Basissatz hinaus ein.

Gebaut mit ❤️ in der Schweiz 🇨🇭