OpenStatus

The Open-Source synthetic monitoring platform.
Learn more »

Discord · Website · Issues

About OpenStatus 🏓

OpenStatus is open-source synthetic monitoring platform.

• Synthetic monitoring: Monitor your website and APIs globally and receive notifications when they are down or slow.

Recognitions 🏆

Contact us 💌

If you are interested in our enterprise plan or need special features, please email us at ping@openstatus.dev or book a call

Contributing 🤝

If you want to help us building the best status page and alerting system, you can check our contributing guidelines

Top Contributors

Made with Contrib.rocks

Stats

Tech stack 🥞

• Next.js
• Tailwind CSS
• shadcn/ui
• tinybird
• turso
• drizzle
• Resend

Getting Started 🚀

With Docker (Recommended)

The fastest way to get started for both development and self-hosting:

1# 1. Copy environment file
2cp .env.docker.example .env.docker
3
4# 2. Start all services
5docker compose up -d
6
7# 3. Access the application
8open http://localhost:3002  # Dashboard
9open http://localhost:3003  # Status Pages

📖 Full guide: DOCKER.md | Production deployment: DOCKER_PRODUCTION.md

With Devbox

You can use Devbox and get started with the following commands:

1. Install Devbox
   Copy

   1curl -fsSL https://get.jetify.com/devbox | bash

2. Install project dependencies, build and start services
   Copy

   1devbox services up

Manual Setup

Requirements

• Node.js >= 20.0.0
• pnpm >= 8.6.2
• Bun
• Turso CLI

Setup

1. Clone the repository

1git clone https://github.com/openstatushq/openstatus.git

2. Install dependencies

1pnpm install

3. Initialize the development environment

Launch the database in one terminal:

1turso dev --db-file openstatus-dev.db

In another terminal, run the following command:

1pnpm dx

4. Launch whatever app you wish to:

1pnpm dev:web
2pnpm dev:status-page
3pnpm dev:dashboard

The above commands whill automatically run the libSQL client on 8080 so you might wanna kill the turso command from step 3.

5. See the results:

• open http://localhost:3000 (default port)

Videos

Videos to better understand the OpenStatus codebase:

• The code behind OpenStatus and how it uses Turbopack.
• Drop Betterstack and go open source