Skip to content
This repository has been archived by the owner on Dec 13, 2023. It is now read-only.


Repository files navigation

🔔 Pong

Self-deployed server uptime monitoring.

Do you have servers that you need to ensure are up at all times? Are you also annoyed that dedicated uptime monitoring services cost more than the servers you're running on? Then just deploy your own monitoring server. That's where Pong comes in.

Pong lets you

  • define URLs to periodically call with a specified HTTP method and an optional body
  • define assertions that need to be verified after a response returns
  • run all these periodically (every 60 seconds by default)
  • if any assertion fails, you get an email telling you which assertion failed
  • you get an email again once the failure has been fixed
  • configure everything from json files: pings and server.

Very simple, but covers most of the basic needs of ensuring your service is up and functioning correctly. But as always, PR's welcome!

Pong Assertions

Each response from a monitored server is evaluated against a set of assertions. So far these assertions are available:

  • statusCode - ensures a response ended with a specific status code
  • body - ensures a response's body matches provided data

To build more assertions, just create a new type conforming to PongAssertion

Deployment steps

  • fork this repo
  • create a SendGrid account and create new credentials, which you'll supply in $PONG_EMAIL_USERNAME and $PONG_EMAIL_PASSWORD later
  • edit the file Config/pings.json and Config/server.json to your liking
  • create a new droplet on Digital Ocean with Docker running on Ubuntu
  • clone your fork of this project there
  • build the image with docker build .
  • start a container with


where you supply your own environment variables PONG_EMAIL_PASSWORD, PONG_EMAIL_USERNAME and PONG_EMAIL_TARGET (which is for the email address to which to send emails when you services go down). IMAGE_ID is the built image from docker build .

Web frontend

If you navigate to your server in the browser, you'll get a quick status page

Email notifications

And of course, if you're on the go and any of your servers goes down, you'll find out immediately. Not from people on Twitter hours later :-)

Code of Conduct

In order to have a more open and welcoming community, this project adheres to a code of conduct. Please adhere to this code of conduct in any interactions you have in this community. It is strictly enforced on all official repositories, websites, and resources. If you encounter someone violating these terms, please let a maintainer (@levlaz) know and we will address it as soon as possible.

💝 Contributing

Please create an issue with a description of your problem or open a pull request with a fix.

✌️ License


👽 Original Author

Honza Dvorsky -, @czechboy0