Hetzner Provider

The Hetzner Machine Provider can create Hetzner Servers and attach them to pre-existing Hetzner networks. This means, you will need to pre-create these first.

You will also need to create a Hetzner API token.

For now, please follow the official Hetzner documentation for all this. We will later provide more detailed documentation here.

A Hetzner provider can be created via the dashboard or the CLI.

Creating a Hetzner Machine Provider

To create a Hetzner Machine Provider via the CLI, run:

dboxed machine-provider create --name <mp-name> --type=hetzner \
  --hetzner-cloud-token=<hetzner-cloud-token> \
  --hetzner-network-name=<hetzner-network-name>

Replace all the argument placeholders with the appropriate values.

Creating a Hetzner Machine

To create a Hetzner machine with an automatically created instance, run:

dboxed machine create --name=<machine-name> --machine-provider=<mp-name> \
  --hetzner-server-type=<hetzner-server-type> --hetzner-server-location=<hetzner-server-location>

After that, you can add/remove boxes to the machine via the usual means.

Networking

The Hetzner Machine Provider will create instances in the provided Hetzner network.

Running machines in the same network has the advantage that Dboxed networks will be able to leverage P2P connections without leaving the Hetzner network, allowing you to speed up networking and reduce costs.