Skip to content

DNS: Add Hetzner cloud#892

Open
Ayesh wants to merge 1 commit intosrvrco:masterfrom
Ayesh:hetzner-cloud-dns
Open

DNS: Add Hetzner cloud#892
Ayesh wants to merge 1 commit intosrvrco:masterfrom
Ayesh:hetzner-cloud-dns

Conversation

@Ayesh
Copy link
Copy Markdown
Contributor

@Ayesh Ayesh commented Apr 1, 2026

Getssl supports Hetzner DNS API, but they are phrasing out1 the DNS API.

This adds support for Hetzner's Cloud API2 to manage zones to add and remove ACME DNS records.

Similar to the Hetzner DNS API integration, this works by setting additional environment variables either within the global .getssl config file, or certificate-specific getssl.cfg file.

  • HETZNER_KEY: Required, set project-specific API key.
  • HETZNER_ZONE_ID: The numeric zone ID
  • HETZNER_ZONE_NAME: If HETZNER_ZONE_ID is not provided, the zone ID will be fetched by searching for this name. This may not work reliably, and setting HETZNER_ZONE_ID is recommended.

Either HETZNER_ZONE_ID or HETZNER_ZONE_ID must be set.

The system also must have jq installed.

Footnotes

  1. https://docs.hetzner.com/networking/dns/migration-to-hetzner-console/process/

  2. https://docs.hetzner.cloud/reference/cloud#tag/zones

Getssl supports Hetzner DNS API, but they are phrasing out[^1] the DNS
API.

This adds support for Hetzner's Cloud API[^2] to manage zones to add
and remove ACME DNS records.

[^1]: https://docs.hetzner.com/networking/dns/migration-to-hetzner-console/process/
[^2]: https://docs.hetzner.cloud/reference/cloud#tag/zones

Similar to the Hetzner DNS API integration, this works by setting
additional environment variables either within the global `.getssl`
config file, or certificate-specific `getssl.cfg` file.

 - `HETZNER_KEY`: Required, set project-specific API key.
 - `HETZNER_ZONE_ID`: The numeric zone ID
 - `HETZNER_ZONE_NAME`: If `HETZNER_ZONE_ID` is not provided, the zone
    ID will be fetched by searching for this name. This may not work
	reliably, and setting `HETZNER_ZONE_ID` is recommended.

Either `HETZNER_ZONE_ID` or `HETZNER_ZONE_ID` _must_ be set.

The system also must have `jq` installed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant