Performance & availability monitoring app Built on Spring Boot & Quasar Frameworks Check out the demo
Netcheck lets you monitor the availability and performance of your websites or web services by running on your own servers/machines or hosting providers of your preference. It is inspired by services like Pingdom and Statuscake
This git repository is for the api/backend side of the app. For an easy way to control the app and check the state and performance of your websites check out the Netcheck Frontend Repository and its instructions on how to run it.
WARNING: The app is still under heavy development and quite rough around the edges. Feel free to report any bugs you may encounter, provide feedback or request features you would love to see in the future through the github issues page.
The fastest way to run Netcheck is through docker, and the provided docker-compose.yml file to get all the required dependancies up and running
Running a private instance locally with OpenJDK
Using docker (recommended)
database.envand change the credentials for the db to something more appropriate. This env file is going to be used both by the postgress docker container to init the db as well as the netcheck app in order to connect to it.
.env. The default values are enough for connecting to the db in the previous step. If you want Notifications support through pushover change the
trueand fill the
SETTINGS_NOTIFICATIONS_PUSHOVER_USERIDTOKENwith the values you are going to get from Pushover after creating a new app.
docker-compose up -dto bring everything up.
Running publicly through traefik reverse proxy
Features: ⚡️ Built on Spring Boot (backend - this repo) and Quasar (Frontend) ⚡️ Supports live checking of domains through HTTP and HTTPS ⚡️ Supports scheduled checks with custom check intervals per domain ⚡️ Customizable endpoint, request headers and timeout threshold on all checks ⚡️ HTTPS Certificate validation checks ⚡️ Metric Generation for uptime and response times ⚡ Aggregation of arbitrary metrics sent by Servers ⚡️ State change notification system (currently supports Webhooks, SSE and Pushover)
Other key features coming: ⚡️ Authentication ⚡️ Multi user/teams support through KeyCloak ⚡️ Additional notification providers (Email, Pushbullet, Telegram, Discord, Slack, Kafka, etc) ⚡ Additional check implementations (SSH, TCP, UDP, RDP, etc) ⚡️ Multi location support for the scheduled checks ⚡️ Scalability of the service when running in clusters (Kubernetes, Docker Swarm, etc)
What is Netcheck designed for
Netcheck may not include the vast feature set the aforementioned services provide, but it gives you full control over your data and doesn't lock you in to a single provider. And since it is self hosted it can also run exclusively on your intranet/cluster and check non publicly available services.
*Note that all licence references and agreements mentioned in the netcheck README section above are relevant to that project's source code only.