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