Back to Templates

OpenStatus is an open source alternative to your current monitoring service with a beautiful status page.

by mxkaske, thibaultleouay
OpenStatus is an open source alternative to your current monitoring service with a beautiful status page.


The Open-Source website & API monitoring platform.
Learn more Β»

Discord Β· Website Β· Issues Β· Roadmap

About OpenStatus πŸ“

OpenStatus is open-source synthetic monitoring platform with beautiful status page and incident management. We are building it publicly for everyone to see our progress. We believe great softwares are built this way.

You can choose to host it yourself or use our hosted version at

Contact us πŸ’Œ

If you want to learn more about this project or have any questions, book a call with us or send us an email at

Book us with

Built with πŸ› οΈ

Getting Started πŸš€



  1. Clone the repository

    git clone
  2. Install dependencies

    pnpm install
  3. Set up your .env file

    From apps/web and packages/db, you will find .env.example. Create your own copy.

  4. Follow the steps to run your sqlite database locally inside of

  5. Start the development with the below command

     pnpm dev

    It will:

    • run the web app on port 3000
    • run the api server on port 3001
    • run the docs on port 3002
  6. See the results:

For clerk, you will need to create a webhook endpoint. To access the link, you can use tunneling tools like Tunnelmole, an open source tunnelling tool or ngrok, a popular closed source tunnelling tool.

Using Tunnelmole

  1. Install Tunnelmole with curl -O && sudo bash install. (On Windows, download tmole.exe)
  2. Run tmole 3000. In the output, you'll see two URLs, one HTTP, and an HTTPS URL. It's best to use the HTTPS URL for privacy and security.
➜  ~ tmole 3000 is forwarding to localhost:3000 is forwarding to localhost:3000

Append /api/webhook/clerk to the HTTPs URL.

Using ngrok

After login, append /api/webhook/clerk to the link you get after entering:

$ ngrok http 3000


Videos to better understand the OpenStatus codebase:

Roadmap πŸ—ΊοΈ

Here's our roadmap feel free to contribute to it.

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