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.env
file 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 start
The 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 -d
You can also use the Docker image directly from GitHub Container Registry with the following command:
docker compose up -d
You 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