/ 
WWW-Hetzner-0.101
/ hrobot.pl

NAME

hrobot.pl - Hetzner Robot CLI (Perl implementation)

VERSION

version 0.101

SYNOPSIS

# List servers
hrobot.pl server list

# Show server details
hrobot.pl server describe 123456

# Boot the rescue system, then reset into it
hrobot.pl boot rescue 123456 --enable --os linux
hrobot.pl reset 123456 --type hw

# Reset server
hrobot.pl reset 123456
hrobot.pl reset 123456 --type hw

# List SSH keys
hrobot.pl key list

# JSON output
hrobot.pl -o json server list

DESCRIPTION

Perl implementation of a CLI for the Hetzner Robot API. This is for managing dedicated servers, unlike hcloud.pl which manages cloud servers.

OPTIONS

-u, --user=USER

Robot webservice username. Defaults to HETZNER_ROBOT_USER env.

-p, --password=PASSWORD

Robot webservice password. Defaults to HETZNER_ROBOT_PASSWORD env.

-o, --output=FORMAT

Output format: table (default) or json.

COMMANDS

server

Manage dedicated servers.

hrobot.pl server list          # List all servers
hrobot.pl server describe ID   # Show server details

key

Manage SSH keys.

hrobot.pl key list             # List all keys

reset

Reset a server.

hrobot.pl reset ID             # Software reset
hrobot.pl reset ID --type hw   # Hardware reset
hrobot.pl reset ID --type man  # Manual reset (technician)

wol

Wake-on-LAN.

hrobot.pl wol ID

traffic

Query traffic statistics.

hrobot.pl traffic --ip 1.2.3.4 --type day --from 2024-01-01T00 --to 2024-01-02T00
hrobot.pl traffic --ip 1.2.3.4 --type month --from 2024-01-01 --to 2024-02-01
hrobot.pl traffic --ip 1.2.3.4 --type year --from 2024-01 --to 2024-12

boot

Boot configuration: rescue system and unattended installations. Activating an option only arms it - the server has to be reset to boot into it. The response of an activating call carries the generated password.

hrobot.pl boot ID                      # Status of all boot options
hrobot.pl boot rescue ID               # Rescue system status
hrobot.pl boot rescue ID --enable --os linux
hrobot.pl boot rescue ID --disable
hrobot.pl boot linux ID --enable --dist 'Debian 12 minimal' --lang en
hrobot.pl boot vnc ID --enable --dist centOS-5.0 --lang en_US
hrobot.pl boot windows ID --enable --os 'Windows Server 2022 Standard Edition' --lang en

rdns

Manage reverse DNS entries.

hrobot.pl rdns                                     # List all entries
hrobot.pl rdns 203.0.113.50                        # Show one entry
hrobot.pl rdns 203.0.113.50 --ptr mail.example.com # Set the PTR record
hrobot.pl rdns 203.0.113.50 --delete               # Delete the entry

failover

Manage failover IP routing.

hrobot.pl failover                                 # List all failover IPs
hrobot.pl failover 203.0.113.60                    # Show one failover IP
hrobot.pl failover 203.0.113.60 --to 198.51.100.10 # Route to another server
hrobot.pl failover 203.0.113.60 --delete           # Delete the routing

ENVIRONMENT

HETZNER_ROBOT_USER

Robot webservice username.

HETZNER_ROBOT_PASSWORD

Robot webservice password.

SEE ALSO

WWW::Hetzner::Robot, https://robot.hetzner.com/doc/webservice/en.html

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://github.com/Getty/p5-www-hetzner/issues.

IRC

Join #kubernetes on irc.perl.org or message Getty directly.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de>

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.