This is a NodeJS application that checks for the availability of OVH / Kimsufi / SoYouStart servers (according to servers.json config file) and if they are in stock, it can trigger:
- An email through a configured SMTP server.
- An SMS message through Twilio.
- A PushBullet notification.
- Telegram notification.
All the configuration can be made through two files:
.env-> Where all the credentials and other config are stored (ie: SMTP, Twilio API, Pushbullet, Telegram, etc). Create your own.envfile from.env.sample.servers.json-> Where you can add the OVH / Kimsufi / SoYouStart servers you want to monitor.
# Install all dependencies:
yarn install
# or just:
yarn
# Run application
yarn startThe following command will build the Docker image, based on a NodeJS Alpine image, so should have a fairly small footprint, and spin it up in the background:
docker compose up -f docker-compose.dev.yml -dYou can also use the Docker image directly from GitHub Container Registry with the following command:
docker compose up -dYou can easily use it out of the box and run it in a headless server like a cheap VPS using Docker. It will run in the background, even after you have logged out of the server.
MIT License
Copyright (c) 2023 Jorge Barnaby
See LICENSE