Source
Documentation (self-hosting) — openstatus
Checked for openstatus on 1 Nov 2026
- Page
- https://www.openstatus.dev/docs/guides/self-hosting-openstatus
- Checked
- 1 Nov 2026, 10:41 UTC
- How we may use it
- Public page, crawling permitted
Technical details
- type
- page
- http status
- 200
- content hash
- sha256:c9d30ec6729a5cafc564a147297ec15c0f115735a98d6e7469b34f90a306bbf3
- permission
- robots_ok
- screenshot
- Screenshot on file (internal exhibit, not published)
Cited by
Facts read from this source
-
Self hosting available Report an error
“openstatus provides a Docker Compose setup that makes self-hosting straightforward.”
-
Self hosting kubernetes helm Report an error
“On Kubernetes, use the Helm chart instead — see Running on Kubernetes.”
-
Self hosting status page only Report an error
“the lightweight status-page-only setup runs four services instead of the full stack — no Tinybird, no probes, no API server.”
-
Self hosting limitation private locations Report an error
“It only works with private locations. You have to deploy our probes to the cloud provider of your choice.”
-
Self hosting ip restriction limitation Report an error
“The IP restriction feature for status pages relies on the X-Forwarded-For header, which Vercel overwrites with the verified client IP. When self-hosting behind a different reverse proxy, clients can spoof this header to bypass IP restrictions.”
-
Self hosting docker images Report an error
“Probe ghcr.io/openstatushq/private-location:latest”
-
Self hosting AI assistant default off Report an error
“It is off by default when self-hosting — the chat endpoint returns 503 "Chat is not configured" until you point it at a model provider.”
-
Self hosting AI openai compatible Report an error
“Use any OpenAI-compatible API — NVIDIA NIM, vLLM, Ollama, OpenRouter, Neon AI Gateway, LM Studio, or a private gateway.”
-
Self hosting service architecture Report an error
“workflows 3000 Background jobs and scheduled tasks server 3001 API backend (ConnectRPC + REST v1) dashboard 3002 Admin interface for configuration status-page 3003 Public status pages private-location 8081 Ingest server — receives results from probes”
-
Self hosting analytics tinybird Report an error
“openstatus stores every check result in Tinybird. Without a working Tinybird setup you can create monitors and probes, but the dashboard will show no data.”
-
Self hosting prebuilt images Report an error
“Use docker compose -f docker-compose.github-packages.yaml up -d, which pulls from ghcr.io/openstatushq/* instead.”
-
Self hosting cron required Report an error
“Self-hosted deployments need external cron scheduling for background tasks. Without these, critical features like private location health monitoring won't work.”
-
Self hosting probe refresh interval Report an error
“The probe refreshes its monitor list every 10 minutes.”
-
Self hosting workspace limits manual Report an error
“Because this is a self-hosted instance, you need to manually set the feature limits for your workspace directly in the database.”
-
Self hosting paid plan unlock Report an error
“UPDATE workspace SET plan='team', paid_until=strftime('%s','now') + 315360000, ends_at=NULL WHERE id=1;”
-
Self hosting AI vercel gateway Report an error
“If you use the Vercel AI Gateway, set a single key. The model is chosen automatically (a smaller model for free workspaces, a stronger one for paid).”
Scores citing this record
- The Agency Developer European sovereignty
- The Customer Support Lead Uptime reports, data & the vendor's own reliability
- The Customer Support Lead European sovereignty
- The E-Commerce Operations Manager Uptime reports, data & the vendor's own reliability
- The E-Commerce Operations Manager European sovereignty
- The SaaS Platform Engineer Uptime reports, data & the vendor's own reliability
- The SaaS Platform Engineer European sovereignty
- The Information Security Officer Uptime reports, data & the vendor's own reliability
- The Information Security Officer European sovereignty
- The Skeptic Uptime reports, data & the vendor's own reliability
- The Skeptic European sovereignty