Repository files navigation

An open source uptime and infrastructure monitoring application

This repository contains thefrontend of Checkmate, an open-source, self-hosted monitoring tool for tracking server hardware, uptime, response times, and incidents in real time with beautiful visualizations. Checkmate regularly checks whether a server/website is accessible and performs optimally, providing real-time alerts and reports on the monitored services' availability, downtime, and response time.

Checkmate also has an agent, calledCapture, to retrieve data from remote servers. While Capture is not required to run Checkmate, it provides additional insigths about your servers' CPU, RAM, disk and temperature status.

Checkmate has ben stress tested with 1000+ active monitors without any particular issues or performance bottlenecks.

Welove what we are building here, and we contibuously learn a few things about Reactjs, Nodejs, MongoDB and Docker while building Checkmate.

For backend files, please checkCheckmate backend repository.

SeeCheckmate in action. The username isuptimedemo@demo.com and the password is Demouser1! (just a note that we update the demo server from time to time, so if it doesn't work for you, please ping us on Discussions channel).

Usage instructions can be foundhere. It's still WIP and some of the information there might be outdated as we continuously add features weekly. Rest assured, we are doing our best! :)

See installation instructions inCheckmate documentation portal. Alternatively, you can also useCoolify orElestio for a one click Docker deployment. If you would like to monitor your server infrastructure, you'll needCapture agent. Capture repository also contains the installation instructions.

If you would like to use Checkmate in your language, pleasego to this page and register for the language you would like to translate Checkmate to.

Thanks to extensive optimizations, Checkmate operates with an exceptionally small memory footprint, requiring minimal memory and CPU resources. Here’s the memory usage of a Node.js instance running on a server that monitors 323 servers every minute:

You can see the memory footprint of MongoDB and Redis on the same server (398Mb and 15Mb) for the same amount of servers:

If you have any questions, suggestions or comments, please use ourDiscord channel. We've also launched ourDiscussions page! Feel free to ask questions or share your ideas—we'd love to hear from you!

• Completely open source, deployable on your servers
• Website monitoring
• Page speed monitoring
• Infrastructure monitoring (memory, disk usage, CPU performance etc) - requiresCapture
• Docker monitoring
• Ping monitoring
• SSL monitoring
• Port monitoring
• Incidents at a glance
• E-mail notifications
• Scheduled maintenance

Short term roadmap:

• Global (distributed) uptime checking on Solana network (in progress)#1593
• Status pages (in progress)#1131
• Translations (i18n) (in progress)
• Better notification options (Webhooks, Discord, Telegram, Slack) (in progress)#1545
• JSON query monitoring#1573
• Tagging/grouping monitors#1546
• More configuration options
• DNS monitoring

• ReactJs
• MUI (React framework)
• Node.js
• MongoDB
• Recharts
• Lots of other open source components!

• If you would like to support us, please consider giving it a ⭐ and click on "watch".
• Have a question or suggestion for the roadmap/featureset? Check ourDiscord channel orDiscussions forum.
• Need a ping when there's a new release? UseNewreleases, a free service to track releases.
• Watch a Checkmateinstallation and usage video

We areAlex (team lead),Vishnu,Mohadeseh,Gorkem,Owaise, andAryaman helping individuals and businesses monitor their infra and servers.

We pride ourselves on building strong connections with contributors at every level. Despite being a young project, Checkmate has already earned 4.6K+ stars and attracted 60 contributors from around the globe.

Our repo is starred by employees fromGoogle, Microsoft, Intel, Cisco, Tencent, Electronic Arts, ByteDance, JP Morgan Chase, Deloitte, Accenture, Foxconn, Broadcom, China Telecom, Barclays, Capgemini, Wipro, Cloudflare, Dassault Systèmes and NEC, so don’t hold back — jump in, contribute and learn with us!

Here's how you can contribute:

0. Star this repo :)
1. CheckContributor's guideline. First timers are encouraged to checkgood-first-issue tag.
2. Optionally, readproject structure andhigh level overview.
3. Open an issue if you believe you've encountered a bug.
4. Check for good-first-issue's if you are a newcomer.
5. Make a pull request to add new features/make quality-of-life improvements/fix bugs.

Thanks toGitbook for giving us a free tier for their documentation platform, andPoeditor providing us a free account to use their i18n services. If you would like to sponsor Checkmate, please send an email tohello@bluewavelabs.ca

Also check other developer and contributor-friendly projects of BlueWave:

• LangRoute, an LLM proxy and gateway
• DataRoom, an secure file sharing application, aka dataroom.
• Headcount, a complete Human Resource Management platform.
• Guidefox, an application that helps new users learn how to use your product via hints, tours, popups and banners.
• VerifyWise, the first open source AI governance platform.