OneUptime

OneUptime is an open-source observability platform. It checks that your websites, APIs and servers work, collects the logs, metrics and traces your apps send, pages whoever is on call when something breaks, and tells your customers on a status page. It all happens in one product, so the tool that notices a problem is the one that pages your team.

You can use it on OneUptime Cloud or run it on your own servers.

What it does

• Monitoring: Check websites, APIs, ports, DNS and certificates from probes around the world or from inside your own network. OneUptime also watches servers, Kubernetes, Docker, VMware, databases and network devices.
• Incidents and on-call: Work each incident on one timeline. Page whoever is on call by phone, SMS, email, push, Slack or Microsoft Teams, and escalate until someone responds.
• Status pages: Keep customers informed on public or private status pages, and announce scheduled maintenance there.
• Logs, metrics and traces: Send them with OpenTelemetry, search them and build dashboards. Exceptions, profiles, real user monitoring and security events live in the same place.
• Workflows and runbooks: Automate routine work, and connect Jira, ServiceNow and the other tools your team already uses.
• OneUptime AI: Investigates new incidents and alerts and posts a root cause analysis with citations. When you turn fixing on, it can open a pull request with a fix for your team to review.
• API, CLI and Terraform: Automate OneUptime from your scripts and CI, and manage monitors, status pages and on-call as code.
• MCP server (https://oneuptime.com/mcp): Connect Claude, Cursor, VS Code with GitHub Copilot or any other client of the Model Context Protocol (MCP), and ask it to look into an incident, query logs and traces, acknowledge an alert or set up a monitor.

Step-by-step guides take one job from start to finish, on OneUptime Cloud or your own server: Know When Your Website or API Is Down, Get Paged by Phone, SMS or Push and Publish a Status Page.

Everything else is in the docs.

Get started

OneUptime Cloud

Sign up and create a project. The free plan needs no credit card.

Self-host with Docker Compose

You need a Linux server with at least 8 GB of memory. On a new Ubuntu, Debian or RHEL-based server, one command installs Docker, Git and Node.js where they are missing, asks for the address people will use and starts OneUptime:

curl -fsSL https://oneuptime.com/install.sh | bash

Or do it step by step, with Docker, Docker Compose, Git and Node.js installed. In step 3, put the domain name or IP address people will use to reach OneUptime in place of <your-address>, without http://: that is HOST in config.env. Keep localhost only to try OneUptime on your own computer.

# 1. Clone the release branch
git clone --depth 1 --single-branch --branch release https://github.com/OneUptime/oneuptime.git
cd oneuptime

# 2. Create your config
cp config.example.env config.env

# 3. Set HOST to the address people will use
sed -i.bak "s/^HOST=.*/HOST=<your-address>/" config.env && rm config.env.bak

# 4. Start everything
npm start

npm start checks the server, gives every secret in config.env its own random value and starts OneUptime. When it prints OneUptime is up!, open http://localhost, or your server's address, and sign up. The first account becomes the instance's admin.

Then follow the Self-Hosting Guide through HTTPS, email and SMS to your first page. The Docker Compose guide covers server sizes, backups and updates.

Kubernetes with Helm

For production at scale, or high availability, install the Helm chart. Set host to the domain name or IP address people will use to reach OneUptime:

helm repo add oneuptime https://helm-chart.oneuptime.com/
helm install my-oneuptime oneuptime/oneuptime --set host=oneuptime.example.com

The chart's README covers storage, HTTPS, databases and upgrades.

Community and Enterprise

• Community Edition: Free and open source, with everything above, including SAML and OIDC single sign-on.
• Enterprise Edition: Adds SCIM provisioning, audit logs, team compliance and instance health dashboards, with priority support. Production use needs a license: contact sales.

The docs compare the two editions.

Get help

• Ask questions in the OneUptime community on Slack.
• Report bugs and request features in GitHub issues.
• Report a security vulnerability privately, as SECURITY.md explains.
• Email [email protected] about anything else.

Contributing

Bug fixes, features, docs and tests are all welcome. The local development guide shows how to run OneUptime from source, and the contributing guidelines explain how pull requests and licensing work. Issues labeled good first issue are a good place to start.

If OneUptime is useful to you, star this repository or sponsor the project.

License

OneUptime is open source under the Apache License 2.0, except for the ee/ directory. That directory holds the Enterprise Edition and is licensed under the OneUptime Enterprise License. The Community Edition image contains no code from ee/. The root LICENSE file sets out this split.