Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.
This page is a checklist of the settings an operator must verify when deploying Cloosphere to production.
Expand each item to see the exact values and cautions.
Admin panel settings (GUI) are stored in the DB as PersistentConfig and applied automatically. This page covers the items you cannot change through the GUI — environment variables and external dependencies.
Required Every environment
Point CLOOSPHERE_PUBLIC_URL at an external HTTPS FQDN
Variable
Use
Example
CLOOSPHERE_PUBLIC_URL
External access base URL. Used for embed widget callbacks, manifest validDomains auto-computation, and more
https://cloosphere.yourdomain.com
CLOOCUS_PUBLIC_URL
Public base URL for the SR (Service Request) feature. Set together with SR_KEY to enable SR
https://cloosphere.yourdomain.com
When CLOOSPHERE_PUBLIC_URL is unset:
Embed widget callback URLs are wrongly exposed as an internal IP/host
Teams bot manifest validDomains computation errors
(The SR feature is controlled separately by CLOOCUS_PUBLIC_URL + SR_KEY.)Always specify an HTTPS public FQDN. Behind a proxy (Nginx/Cloudflare), enter the externally visible URL.
Verify the PostgreSQL connection through DATABASE_URL
Variable
Tier
Use
DATABASE_URL
Required
PostgreSQL connection string
DATABASE_SCHEMA
Recommended
Schema separation for multi-tenant deployments (default public)
If the connection drops, /health/db returns 503 plus an error detail. Check this endpoint right after deploying.
Apply Alembic migrations to the correct schema at the latest revision
The deployed code version and the DB schema version must match. A missing migration surfaces at runtime as a missing column or table error.
In a multi-worker environment migrations must run exactly once. Concurrent workers attempting migration collide (fixed by an automatic lock in recent versions). See the “Serialize container startup” item in the multi-worker group for how to serialize.
Set backup cadence for PostgreSQL, file storage, and the AGE graph
PostgreSQL — PersistentConfig, users, audit logs, and other core data
File storage — uploaded documents and images
AGE graph — the Knowledge Graph lives inside PostgreSQL, but large graphs are safer with their own backup cadence.
Establish a regular backup policy that covers all three.
Multi-worker Required with 2+ workers
Set REDIS_URL (PersistentConfig sync · session sharing)
Variable
Tier
Use
REDIS_URL
Multi-worker
Required for multi-worker, optional for a single worker
REDIS_SENTINEL_HOSTS
Optional
When using Redis Sentinel
REDIS_SENTINEL_PORT
Optional
(default 26379)
REDIS_URL is required in multi-worker environments. Operating without Redis:
PersistentConfig is held only in per-worker memory → settings drift between workers
Session data such as per-user agent selection is lost
Teams bot / embed widget user context is lost
When the Redis connection fails, Cloosphere fast-fails on a 5-second timeout and switches to an in-memory fallback (single-worker mode). In multi-worker deployments, monitor Redis availability through the health endpoints.
Mount the same file storage volume on every worker
If workers reach different local files, a file uploaded to one worker does not exist on another. Mount the same shared volume (NFS, object storage, etc.) identically on every worker.
Keep environment variables and the timezone (TZ) identical across workers
Mismatched environment variables → behavior differs depending on which worker a user lands on
Mismatched timezone (TZ) → schedule and audit log timestamps disagree between workers
Verify every worker boots with the same environment variable set and the same TZ.
Serialize container startup to avoid migration conflicts
Item
Impact when missed
Alembic migrations run exactly once
Concurrent workers collide (fixed by a lock in recent versions)
Alembic migration conflicts are resolved by an automatic lock in recent versions, but serializing container start order — for example, waiting for the first worker’s healthcheck to pass before starting the rest — is safer.
Remove the single point of failure with Redis Sentinel or Cluster (recommended)
Recommended A single Redis instance takes the whole service down when it fails. Use Sentinel or Cluster for high availability. Configure it through REDIS_SENTINEL_HOSTS / REDIS_SENTINEL_PORT.
Optional Only for the features you use
SSO / OIDC integration
To enable OAuth/OIDC SSO, set the following environment variables (Keycloak, Entra ID, and Google all use the same interface).
Requested scopes (openid email profile is the default)
OAUTH_PROVIDER_NAME
Provider name shown on the sign-in screen
Keycloak organization sync runs on the client_credentials grant flow. Once all the variables above are set, the Keycloak sync option becomes available on the Organization Management screen.
See the Authentication items under General settings for more.
Teams bot registration · manifest upload
To operate a Microsoft Teams bot:
TEAMS_BOT_APP_ID=<Azure Bot Client ID>TEAMS_BOT_APP_PASSWORD=<Client Secret>TEAMS_BOT_TENANT_ID=common # or a single-tenant GUIDTEAMS_BOT_ENABLED=trueTEAMS_BOT_BACKEND_TIMEOUT=300TEAMS_BOT_DEFAULT_LOCALE=ko-KR
The Teams bot requires Redis in multi-worker environments. Per-user agent selection state has to be shared across workers.
Size the AGE pool to your KG data volume (recommended)
Recommended If you use the Knowledge Graph, size the connection pool to your data volume.KG fan-out extraction uses many concurrent connections, so at larger volumes pool exhaustion can fail a sync. Adjust the pool size to match.
Variable
Default
< 10M nodes
10M–100M nodes
> 100M nodes
AGE_POOL_MIN
2
2
4
8
AGE_POOL_MAX
32
16
32 (default)
64+
On pool exhaustion Cloosphere automatically performs 5 retries with exponential backoff (0.1s × 2^attempt). Seeing [age_service] pool initialized in the logs means initialization succeeded. Repeated PoolError or connection pool exhausted means it is time to raise the pool size one tier.
Recommended Monitoring · backup
Register the /health endpoints with external monitoring
Cloosphere exposes health endpoints you can wire into external monitoring (Prometheus, Datadog, Azure Monitor, etc.).
Recommend /health/db for the CI/CD readiness probe and /health for the liveness probe.
The System Diagnostics panel is not an always-on screen inside the admin panel. It appears only inside the “Service Connection Error” screen — shown when the app fails to start — and only for users signed in as an admin. It lists each component as OK / ERROR with the error message, so during an outage you can tell immediately whether the DB, Redis, or the task queue is down. For routine status checks, call the endpoints above directly.
Verify the audit log license feature
The license must include the audit log (audit_log) feature for operational activity to be recorded. See Audit Logs for how to check and use it.
Related Pages
General
GUI-managed authentication and feature toggles
Teams Bot
Microsoft Teams integration
Channels
Email and webhook notification channels
Troubleshooting
Common issues and solutions in operations
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/admin/deployment-checklist","slug":"/en/admin/deployment-checklist","pageMetadata":{"title":"Deployment Checklist","description":"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.","href":"/en/admin/deployment-checklist"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Heading,Note,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This page is a checklist of the settings an operator must verify when `,_jsx(_components.strong,{children:`deploying Cloosphere to production`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Expand each item to see the exact values and cautions.`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Admin panel settings (GUI) are stored in the DB as `,_jsx(_components.strong,{children:`PersistentConfig`}),` and applied automatically. This page covers the items you `,_jsx(_components.strong,{children:`cannot`}),` change through the GUI — `,_jsx(_components.strong,{children:`environment variables and external dependencies`}),`.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`3`,id:`required-every-environment`,children:[_jsx(`span`,{className:`cloo-badge cloo-badge--required`,children:`Required`}),` Every environment`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Point CLOOSPHERE_PUBLIC_URL at an external HTTPS FQDN`,icon:`square-check`,id:`point-cloosphere-public-url-at-an-external-https-fqdn`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`Use`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:_jsx(_components.code,{children:`CLOOSPHERE_PUBLIC_URL`})})}),_jsx(_components.td,{children:`External access base URL. Used for embed widget callbacks, manifest validDomains auto-computation, and more`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://cloosphere.yourdomain.com`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:_jsx(_components.code,{children:`CLOOCUS_PUBLIC_URL`})})}),_jsxs(_components.td,{children:[`Public base URL for the SR (Service Request) feature. Set together with `,_jsx(_components.code,{children:`SR_KEY`}),` to enable SR`]}),_jsx(_components.td,{children:_jsx(_components.code,{children:`https://cloosphere.yourdomain.com`})})]})]})]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[`When `,_jsx(_components.code,{children:`CLOOSPHERE_PUBLIC_URL`}),` is unset:`]}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Embed widget callback URLs are wrongly exposed as an internal IP/host`}),`\n`,_jsx(_components.li,{children:`Teams bot manifest validDomains computation errors`}),`\n`]}),_jsxs(_components.p,{children:[`(The SR feature is controlled separately by `,_jsx(_components.code,{children:`CLOOCUS_PUBLIC_URL`}),` + `,_jsx(_components.code,{children:`SR_KEY`}),`.)`]}),_jsxs(_components.p,{children:[`Always specify an `,_jsx(_components.strong,{children:`HTTPS public FQDN`}),`. Behind a proxy (Nginx/Cloudflare), enter the externally visible URL.`]})]})]}),_jsxs(Accordion,{title:`Verify the PostgreSQL connection through DATABASE_URL`,icon:`square-check`,id:`verify-the-postgresql-connection-through-database-url`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Tier`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DATABASE_URL`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(`span`,{className:`cloo-badge cloo-badge--required`,children:`Required`})}),_jsx(_components.td,{children:`PostgreSQL connection string`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DATABASE_SCHEMA`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(`span`,{className:`cloo-badge cloo-badge--recommended`,children:`Recommended`})}),_jsxs(_components.td,{children:[`Schema separation for multi-tenant deployments (default `,_jsx(_components.code,{children:`public`}),`)`]})]})]})]}),_jsxs(_components.p,{children:[`If the connection drops, `,_jsx(_components.code,{children:`/health/db`}),` returns 503 plus an error detail. Check this endpoint right after deploying.`]})]}),_jsxs(Accordion,{title:`Apply Alembic migrations to the correct schema at the latest revision`,icon:`square-check`,id:`apply-alembic-migrations-to-the-correct-schema-at-the-latest-revision`,children:[_jsx(_components.p,{children:`The deployed code version and the DB schema version must match. A missing migration surfaces at runtime as a missing column or table error.`}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`In a multi-worker environment migrations must run `,_jsx(_components.strong,{children:`exactly once`}),`. Concurrent workers attempting migration collide (fixed by an automatic lock in recent versions). See the `,_jsx(_components.em,{children:`“Serialize container startup”`}),` item in the multi-worker group for how to serialize.`]})})]}),_jsxs(Accordion,{title:`Set backup cadence for PostgreSQL, file storage, and the AGE graph`,icon:`square-check`,id:`set-backup-cadence-for-postgresql-file-storage-and-the-age-graph`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`PostgreSQL`}),` — PersistentConfig, users, audit logs, and other core data`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`File storage`}),` — uploaded documents and images`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AGE graph`}),` — the Knowledge Graph lives inside PostgreSQL, but large graphs are safer with their own backup cadence.`]}),`\n`]}),_jsx(_components.p,{children:`Establish a regular backup policy that covers all three.`})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`3`,id:`multi-worker-required-with-2+-workers`,children:[_jsx(`span`,{className:`cloo-badge cloo-badge--multiworker`,children:`Multi-worker`}),` Required with 2+ workers`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Set REDIS_URL (PersistentConfig sync · session sharing)`,icon:`square-check`,id:`set-redis-url-persistentconfig-sync-session-sharing`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Tier`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REDIS_URL`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(`span`,{className:`cloo-badge cloo-badge--multiworker`,children:`Multi-worker`})}),_jsx(_components.td,{children:`Required for multi-worker, optional for a single worker`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REDIS_SENTINEL_HOSTS`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(`span`,{className:`cloo-badge cloo-badge--optional`,children:`Optional`})}),_jsx(_components.td,{children:`When using Redis Sentinel`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`REDIS_SENTINEL_PORT`})}),_jsx(_components.td,{style:{textAlign:`center`},children:_jsx(`span`,{className:`cloo-badge cloo-badge--optional`,children:`Optional`})}),_jsx(_components.td,{children:`(default 26379)`})]})]})]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`REDIS_URL`}),` is required in multi-worker environments.`]}),` Operating without Redis:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`PersistentConfig is held only in per-worker memory → `,_jsx(_components.strong,{children:`settings drift between workers`})]}),`\n`,_jsx(_components.li,{children:`Session data such as per-user agent selection is lost`}),`\n`,_jsx(_components.li,{children:`Teams bot / embed widget user context is lost`}),`\n`]}),_jsxs(_components.p,{children:[`When the Redis connection fails, Cloosphere `,_jsx(_components.strong,{children:`fast-fails on a 5-second timeout`}),` and switches to an in-memory fallback (single-worker mode). In multi-worker deployments, monitor Redis availability through the health endpoints.`]})]})]}),_jsx(Accordion,{title:`Mount the same file storage volume on every worker`,icon:`square-check`,id:`mount-the-same-file-storage-volume-on-every-worker`,children:_jsx(_components.p,{children:`If workers reach different local files, a file uploaded to one worker does not exist on another. Mount the same shared volume (NFS, object storage, etc.) identically on every worker.`})}),_jsxs(Accordion,{title:`Keep environment variables and the timezone (TZ) identical across workers`,icon:`square-check`,id:`keep-environment-variables-and-the-timezone-tz-identical-across-workers`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Mismatched environment variables`}),` → behavior differs depending on which worker a user lands on`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Mismatched timezone (`,_jsx(_components.code,{children:`TZ`}),`)`]}),` → schedule and audit log timestamps disagree between workers`]}),`\n`]}),_jsxs(_components.p,{children:[`Verify every worker boots with the same environment variable set and the same `,_jsx(_components.code,{children:`TZ`}),`.`]})]}),_jsxs(Accordion,{title:`Serialize container startup to avoid migration conflicts`,icon:`square-check`,id:`serialize-container-startup-to-avoid-migration-conflicts`,children:[_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Item`}),_jsx(_components.th,{children:`Impact when missed`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Alembic migrations run exactly once`}),_jsx(_components.td,{children:`Concurrent workers collide (fixed by a lock in recent versions)`})]})})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Alembic migration conflicts are resolved by an automatic lock in recent versions, but `,_jsx(_components.strong,{children:`serializing container start order`}),` — for example, waiting for the first worker’s healthcheck to pass before starting the rest — is safer.`]})})]}),_jsx(Accordion,{title:`Remove the single point of failure with Redis Sentinel or Cluster (recommended)`,icon:`square-check`,id:`remove-the-single-point-of-failure-with-redis-sentinel-or-cluster-recommended`,children:_jsxs(_components.p,{children:[_jsx(`span`,{className:`cloo-badge cloo-badge--recommended`,children:`Recommended`}),` A single Redis instance takes the whole service down when it fails. Use Sentinel or Cluster for high availability. Configure it through `,_jsx(_components.code,{children:`REDIS_SENTINEL_HOSTS`}),` / `,_jsx(_components.code,{children:`REDIS_SENTINEL_PORT`}),`.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`3`,id:`optional-only-for-the-features-you-use`,children:[_jsx(`span`,{className:`cloo-badge cloo-badge--optional`,children:`Optional`}),` Only for the features you use`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`SSO / OIDC integration`,icon:`square-check`,id:`sso-oidc-integration`,children:[_jsx(_components.p,{children:`To enable OAuth/OIDC SSO, set the following environment variables (Keycloak, Entra ID, and Google all use the same interface).`}),_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OPENID_PROVIDER_URL`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`https://auth.example.com/realms/cloosphere/.well-known/openid-configuration`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OAUTH_CLIENT_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`cloosphere-app`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OAUTH_CLIENT_SECRET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`strong-secret`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OAUTH_SCOPES`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"openid email profile\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`OAUTH_PROVIDER_NAME`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Keycloak`})]}),`\n`]})})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`OPENID_PROVIDER_URL`})}),_jsxs(_components.td,{children:[`OIDC Discovery URL (`,_jsx(_components.code,{children:`.well-known/openid-configuration`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`OAUTH_CLIENT_ID`})}),_jsx(_components.td,{children:`Client ID registered with the IdP`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`OAUTH_CLIENT_SECRET`})}),_jsx(_components.td,{children:`Client secret`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`OAUTH_SCOPES`})}),_jsxs(_components.td,{children:[`Requested scopes (`,_jsx(_components.code,{children:`openid email profile`}),` is the default)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`OAUTH_PROVIDER_NAME`})}),_jsx(_components.td,{children:`Provider name shown on the sign-in screen`})]})]})]}),_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Keycloak organization sync`}),` runs on the client_credentials grant flow. Once all the variables above are set, the Keycloak sync option becomes available on the `,_jsx(_components.a,{href:`/en/admin/organizations`,children:`Organization Management`}),` screen.`]})}),_jsxs(_components.p,{children:[`See the Authentication items under `,_jsx(_components.a,{href:`/en/admin/settings/general#authentication-settings`,children:`General`}),` settings for more.`]})]}),_jsxs(Accordion,{title:`Teams bot registration · manifest upload`,icon:`square-check`,id:`teams-bot-registration-manifest-upload`,children:[_jsx(_components.p,{children:`To operate a Microsoft Teams bot:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_APP_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Azure`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` Bot`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Client`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` I`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`D`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_APP_PASSWORD`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=\u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`Client`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` Secret`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_TENANT_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`common`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # or a single-tenant GUID`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_ENABLED`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`true`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_BACKEND_TIMEOUT`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`300`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`TEAMS_BOT_DEFAULT_LOCALE`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`ko-KR`})]}),`\n`]})})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`The Teams bot `,_jsx(_components.strong,{children:`requires Redis in multi-worker environments`}),`. Per-user agent selection state has to be shared across workers.`]})}),_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/en/admin/teams-bot`,children:`Teams Bot guide`}),` for detailed setup.`]})]}),_jsxs(Accordion,{title:`Size the AGE pool to your KG data volume (recommended)`,icon:`square-check`,id:`size-the-age-pool-to-your-kg-data-volume-recommended`,children:[_jsxs(_components.p,{children:[_jsx(`span`,{className:`cloo-badge cloo-badge--recommended`,children:`Recommended`}),` If you use the Knowledge Graph, size the connection pool to your data volume.`]}),_jsx(_components.p,{children:`KG fan-out extraction uses many concurrent connections, so at larger volumes pool exhaustion can fail a sync. Adjust the pool size to match.`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Variable`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`}),_jsx(_components.th,{style:{textAlign:`center`},children:`\u003c 10M nodes`}),_jsx(_components.th,{style:{textAlign:`center`},children:`10M–100M nodes`}),_jsx(_components.th,{style:{textAlign:`center`},children:`> 100M nodes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`AGE_POOL_MIN`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`2`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`2`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`4`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`8`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`AGE_POOL_MAX`})}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`32`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`16`}),_jsx(_components.td,{style:{textAlign:`center`},children:`32 (default)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`64+`})]})]})]}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`On pool exhaustion Cloosphere automatically performs `,_jsx(_components.strong,{children:`5 retries with exponential backoff`}),` (0.1s × 2^attempt). Seeing `,_jsx(_components.code,{children:`[age_service] pool initialized`}),` in the logs means initialization succeeded. Repeated `,_jsx(_components.code,{children:`PoolError`}),` or `,_jsx(_components.code,{children:`connection pool exhausted`}),` means it is time to raise the pool size one tier.`]})})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsxs(Heading,{level:`3`,id:`recommended-monitoring-·-backup`,children:[_jsx(`span`,{className:`cloo-badge cloo-badge--recommended`,children:`Recommended`}),` Monitoring · backup`]}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Register the /health endpoints with external monitoring`,icon:`square-check`,id:`register-the-health-endpoints-with-external-monitoring`,children:[_jsx(_components.p,{children:`Cloosphere exposes health endpoints you can wire into external monitoring (Prometheus, Datadog, Azure Monitor, etc.).`}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Endpoint`}),_jsx(_components.th,{children:`Use`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Auth`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /health`})}),_jsx(_components.td,{children:`Basic liveness check`}),_jsx(_components.td,{style:{textAlign:`center`},children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /health/db`})}),_jsx(_components.td,{children:`DB connection state (503 + error detail if down)`}),_jsx(_components.td,{style:{textAlign:`center`},children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /health/redis`})}),_jsx(_components.td,{children:`Redis ping (503 if unavailable)`}),_jsx(_components.td,{style:{textAlign:`center`},children:`None`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /health/full`})}),_jsx(_components.td,{children:`DB + Redis + TaskQueue overall state`}),_jsx(_components.td,{style:{textAlign:`center`},children:`None`})]})]})]}),_jsx(_components.p,{children:`Response example:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`GET /health/full`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"components\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"db\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"redis\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"mode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"redis\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"task_queue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"connected\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"stream\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cloosphere:tasks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(Tip,{children:_jsxs(_components.p,{children:[`Recommend `,_jsx(_components.code,{children:`/health/db`}),` for the CI/CD readiness probe and `,_jsx(_components.code,{children:`/health`}),` for the liveness probe.`]})}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`System Diagnostics panel`}),` is not an always-on screen inside the admin panel. It appears only inside the `,_jsx(_components.strong,{children:`“Service Connection Error”`}),` screen — shown when the app fails to start — and only for users signed in as an admin. It lists each component as `,_jsx(_components.code,{children:`OK`}),` / `,_jsx(_components.code,{children:`ERROR`}),` with the error message, so during an outage you can tell immediately whether the DB, Redis, or the task queue is down. For routine status checks, call the endpoints above directly.`]})})]}),_jsx(Accordion,{title:`Verify the audit log license feature`,icon:`square-check`,id:`verify-the-audit-log-license-feature`,children:_jsxs(_components.p,{children:[`The license must include the audit log (`,_jsx(_components.code,{children:`audit_log`}),`) feature for operational activity to be recorded. See `,_jsx(_components.a,{href:`/en/monitoring/audit-logs`,children:`Audit Logs`}),` for how to check and use it.`]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related Pages`}),`\n`,_jsxs(Columns,{children:[_jsx(Card,{title:`General`,icon:`sliders`,href:`/en/admin/settings/general`,children:_jsx(_components.p,{children:`GUI-managed authentication and feature toggles`})}),_jsx(Card,{title:`Teams Bot`,icon:`microsoft`,href:`/en/admin/teams-bot`,children:_jsx(_components.p,{children:`Microsoft Teams integration`})}),_jsx(Card,{title:`Channels`,icon:`bell`,href:`/en/admin/notifications`,children:_jsx(_components.p,{children:`Email and webhook notification channels`})}),_jsx(Card,{title:`Troubleshooting`,icon:`wrench`,href:`/en/troubleshooting`,children:_jsx(_components.p,{children:`Common issues and solutions in operations`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Deployment Checklist","description":"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.","href":"/en/admin/deployment-checklist"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Required Every environment","slug":"required-every-environment","depth":3,"children":[]},{"title":"Multi-worker Required with 2+ workers","slug":"multi-worker-required-with-2+-workers","depth":3,"children":[]},{"title":"Optional Only for the features you use","slug":"optional-only-for-the-features-you-use","depth":3,"children":[]},{"title":"Recommended Monitoring · backup","slug":"recommended-monitoring-·-backup","depth":3,"children":[]},{"title":"Related Pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Deployment Checklist - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/admin/deployment-checklist","matchLevel":1},"en":{"href":"/en/admin/deployment-checklist","matchLevel":0}}},"lastModified":"2026-08-26T06:17:14.346Z","originalFileLocation":"en/admin/deployment-checklist.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Deployment Checklist - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/admin/deployment-checklist\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Deployment+Checklist\u0026amp;description=Operator+guide+to+required+environment+variables%2C+multi-worker+settings%2C+external+dependencies%2C+and+monitoring+endpoints+when+deploying+to+production.\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=330ef9dfae76adc47ecbb76bf7a0a6c174b7b594612e92a134debd3190e3f191\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Deployment Checklist - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Resources\u0026amp;title=Deployment+Checklist\u0026amp;description=Operator+guide+to+required+environment+variables%2C+multi-worker+settings%2C+external+dependencies%2C+and+monitoring+endpoints+when+deploying+to+production.\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=330ef9dfae76adc47ecbb76bf7a0a6c174b7b594612e92a134debd3190e3f191\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/admin/deployment-checklist\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/admin/deployment-checklist.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/admin/deployment-checklist\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/admin/deployment-checklist\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/admin/deployment-checklist\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist#webpage\",\"url\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist\",\"name\":\"Deployment Checklist\",\"description\":\"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\",\"dateModified\":\"2026-08-26T06:17:14.346Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloosphere Guide\",\"item\":\"https://docs.cloosphere.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Deployment Checklist\",\"item\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist#article\",\"headline\":\"Deployment Checklist\",\"name\":\"Deployment Checklist\",\"description\":\"Operator guide to required environment variables, multi-worker settings, external dependencies, and monitoring endpoints when deploying to production.\",\"url\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/admin/deployment-checklist#webpage\"},\"dateModified\":\"2026-08-26T06:17:14.346Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/admin/deployment-checklist.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/admin/deployment-checklist"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/en/admin/overview"}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","groups":[{"group":"Resources","pages":[{"title":"Deployment Checklist","href":"/en/admin/deployment-checklist"},{"title":"Troubleshooting","description":"Common symptoms and fixes across seven areas — AI model responses, chat and file upload, Korean/encoding, permissions and access, embeddings and vector search, email and notifications, and operations/deployment","href":"/en/troubleshooting"}]}]}]}]},"basePath":"","title":"Deployment Checklist - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}