Hetzner Server Scouter

Hetzner Server Scouter is a simple tool to find and get notified about the cheapest Hetzner server that meet your exact requirements.

By default, this tool will only output the found servers to the console. However, you can also get notified via telegram (see below).

Available Filters

The following filters are available:

• Price
• CPU name
• RAM size
• Datacenter
  • Frankfurt
  • Helsinki
  • Nürnberg
• Disks
  • Number of disks
  • Size of each (or any) disk
  • Number of Fast storage devices (SSD / NVME)
  • Effective RAID size (0, 1, 5, 6)
• Specials
  • GPU
  • iNIC
  • ECC
  • Hardware RAID

Installation

pip install git+https://github.com/Emily3403/hetzner-server-scouter

Usage

hscout --price 50
hscout --ram 32 --disk-num 4 --disk-num-quick 1
hscout --disk-num 3 --disk-size-raid5 12000
hscout --gpu --ecc --hwr

Notifications

You can get notified when a new server is available. For now, only telegram support is available but this can be easily expanded in the future (pull requests welcome). Simply add the handler process_changes function in the src/hetzner_server_scouter/notifications/crud.py file.

To enable telegram notifications, you need to create a telegram bot. Then, you need to set the following environment variables:

TELEGRAM_BOT_TOKEN=<your bot token>
TELEGRAM_CHAT_ID=<your chat id>

To obtain the Chat ID, send a message to your bot follow this guide.

Systemd Deployment

Usually, you don't want to run this tool manually. Instead, you want to run it periodically and get notified if a new server is available.

Hetzner-Server-Scouter is a user service. To install it run the bin/install-systemd.sh or copy the systemd/hscout.service and systemd/hscout.timer file into $XDG_CONFIG_DIR/systemd/user and enable it:

systemctl --user daemon-reload
systemctl --user enable hscout.timer

Make sure to enable lingering for your user. Otherwise, the service will only be started once you log in.

loginctl enable-linger $USER

This will then run the tool every hour. You can change this by editing the hscout.timer file and adjusting the OnCalendar property. See the systemd documentation for more information.