Building Images for Hetzner Hcloud

Prerequisites for Hetzner Hcloud

  • A Hetzner account
  • Set the environment variables HCLOUD_LOCATION and HCLOUD_TOKEN for your hcloud project

Building Images

The build prerequisites for using image-builder for building hcloud images are managed by running:

make deps-hcloud

From the images/capi directory, run make build-hcloud-<OS> where <OS> is the desired operating system. The available choices are listed via make help. For example: Use make build-hcloud-ubuntu-2404 to build an Ubuntu 22.04 snapshot in hcloud.


In addition to the configuration found in images/capi/packer/config, the hcloud directory includes several JSON files that define the default configuration for the different operating systems.

centos-7.jsonThe settings for the CentOS 7 image
flatcar.jsonThe settings for the Flatcar image
rockylinux-8.jsonThe settings for the RockyLinux 8 image
rockylinux-9.jsonThe settings for the RockyLinux 9 image
ubuntu-2004.jsonThe settings for the Ubuntu 20.04 image
ubuntu-2204.jsonThe settings for the Ubuntu 22.04 image
ubuntu-2404.jsonThe settings for the Ubuntu 24.04 image