Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/theobrigitte/kimsufi-notifier
Script to notify about OVH Eco and Kimsufi servers availability via Telegram and/or OpsGenie
https://github.com/theobrigitte/kimsufi-notifier
dedicated-server kimsufi notify ovh ovhcloud telegram telegram-bot
Last synced: about 18 hours ago
JSON representation
Script to notify about OVH Eco and Kimsufi servers availability via Telegram and/or OpsGenie
- Host: GitHub
- URL: https://github.com/theobrigitte/kimsufi-notifier
- Owner: TheoBrigitte
- License: mit
- Created: 2020-11-05T15:52:10.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-21T00:07:25.000Z (21 days ago)
- Last Synced: 2025-01-21T00:26:23.765Z (21 days ago)
- Topics: dedicated-server, kimsufi, notify, ovh, ovhcloud, telegram, telegram-bot
- Language: Go
- Homepage: https://t.me/KimsufiNotifierBot
- Size: 1.17 MB
- Stars: 55
- Watchers: 5
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## About 
[OVH Eco dedicated servers](https://eco.ovhcloud.com) are known for their low prices and high demand. As a result, they are often out of stock. This program is used to check for server availability, and to place order for servers. Note: the previous Bash script collection was moved to [`bash`](https://github.com/TheoBrigitte/kimsufi-notifier/tree/bash) branch.
This is my playground to learn how the OVH API works, it is then ported into a Telegram Bot at [https://t.me/KimsufiNotifierBot](https://t.me/KimsufiNotifierBot) which is more user-friendly and provides more features.
## Features 
- [List available servers](#list-available-servers) from OVH Eco catalog
- [Check availability](#check-availability) of a specific server in one or multiple datacenters
- [Order a server](#order-a-server) directly from the command line
## Quickstart 
### Using pre-built binaries
Download the latest release from the [Github releases page](https://github.com/TheoBrigitte/kimsufi-notifier/releases).
### Using Go
```
go install github.com/TheoBrigitte/kimsufi-notifier
kimsufi-notifier
```
### Examples 
#### List available servers
List servers from OVH Eco catalog in a specific country and from a specific category.
```
$ kimsufi-notifier list --category kimsufi
planCode category name price status datacenters
-------- -------- ---- ----- ------ -----------
24ska01 Kimsufi KS-A | Intel i7-6700k 4.99 EUR unavailable
25skle01 Kimsufi KS-LE-1 9.99 EUR available bhs
25skleb01 Kimsufi KS-LE-B 9.99 EUR available bhs, fra, gra, waw
25sklea01 Kimsufi KS-LE-A 9.99 EUR available bhs, fra, gra, waw
25skled01 Kimsufi KS-LE-D 12.99 EUR unavailable
25sklec01 Kimsufi KS-LE-C 12.99 EUR unavailable
25sklee01 Kimsufi KS-LE-E 14.99 EUR unavailable
25skle02 Kimsufi KS-LE-2 15.99 EUR unavailable
24sk40 Kimsufi KS-4 | Intel Xeon-E3 1230 v6 16.99 EUR available bhs, fra, gra
24sk10 Kimsufi KS-1 | Intel Xeon-D 1520 16.99 EUR available bhs
24sk20 Kimsufi KS-2 | Intel Xeon-D 1540 18.99 EUR unavailable
24sk30 Kimsufi KS-3 | Intel Xeon-E3 1245 v5 18.99 EUR unavailable
...
```
#### Check availability
Check availability of a specific server in all datacenters.
```
$ kimsufi-notifier check --plan-code 25skle01
planCode memory storage status datacenters
-------- ------ ------- ------ -----------
25skle01 ram-16g-noecc-1333 softraid-2x480ssd unavailable
25skle01 ram-16g-noecc-1333 softraid-2x960ssd unavailable
25skle01 ram-16g-noecc-1333 softraid-3x2000sa unavailable
25skle01 ram-16g-noecc-1333 softraid-3x480ssd unavailable
25skle01 ram-32g-noecc-1333 softraid-2x480ssd unavailable
25skle01 ram-32g-noecc-1333 softraid-2x960ssd unavailable
25skle01 ram-32g-noecc-1333 softraid-3x2000sa available bhs
25skle01 ram-32g-noecc-1333 softraid-3x480ssd unavailable
```
#### Order a server
Place an order a specific server, the order is only placed and not payed for. The order can then be completed by following the URL provided in the output.
```
$ kimsufi-notifier order --plan-code 25skle01 --datacenter bhs --item-option memory=ram-32g-noecc-1333-25skle01,storage=softraid-3x2000sa-25skle01
> cart created id=dd413a3a-1eed-473c-bbe4-2a1c4f3d02c0
> cart item added id=299679179
> cart item configured: dedicated_os=none_64.en
> cart item configured: dedicated_datacenter=bhs
> cart item configured: region=europe
> cart option set: memory=ram-32g-noecc-1333-25skle01
> cart option set: storage=softraid-3x2000sa-25skle01
> cart option set: bandwidth=bandwidth-300-unguaranteed-25skle
> cart assigned
> order completed: url=https://www.ovh.com/cgi-bin/order/display-order.cgi?orderId=xxxxxxxxx&orderPassword=xxxxxxxxxx
```
More info on usage can be found in [USAGE.md](USAGE.md).