github.com/hetznercloud/cli

Removed deprecated Datacenter from Server and Primary IP

Removed the deprecated Datacenter property from the Server and Primary IP resources. Since the property was already removed from the Hetzner Cloud API, we do not consider this a breaking change (see changelog entry).

The hcloud primary-ip create --datacenter and hcloud server create --datacenter flags have been removed in favor of --location. Additionally, hcloud primary-ip describe and hcloud server describe will no longer show the Datacenter property.

In place of the --datacenter flag the --location flag can be used. The Location name is the first part of the Datacenter name, e.g. the part before -. Example:

Before:

$ hcloud server create --datacenter fsn1-dc14
$ hcloud primary-ip create --datacenter hel1-dc2

After:

$ hcloud server create --location fsn1
$ hcloud primary-ip create --location hel1

Features

• add http-timeout option (#1445)
• remove datacenter property from server and primary_ip (#1460)

Bug Fixes

• primary-ip: format IPv6 properly in describe (#1451)

Removed deprecated Datacenter from Server and Primary IP

Removed the deprecated Datacenter property from the Server and Primary IP resources. Since the property was already removed from the Hetzner Cloud API, we do not consider this a breaking change (see changelog entry).

The hcloud primary-ip create --datacenter and hcloud server create --datacenter flags have been removed in favor of --location. Additionally, hcloud primary-ip describe and hcloud server describe will no longer show the Datacenter property.

In place of the --datacenter flag the --location flag can be used. The Location name is the first part of the Datacenter name, e.g. the part before -. Example:

Before:

$ hcloud server create --datacenter fsn1-dc14
$ hcloud primary-ip create --datacenter hel1-dc2

After:

$ hcloud server create --location fsn1
$ hcloud primary-ip create --location hel1

Features

• add http-timeout option (#1445)
• remove datacenter property from server and primary_ip (#1460)

Bug Fixes

• primary-ip: format IPv6 properly in describe (#1451)

Datacenters commands are now deprecated

The hcloud datacenters list and hcloud datacenters describe commands are now deprecated.

The endpoints GET /v1/datacenters and GET /v1/datacenters/{id} are now deprecated and will be removed after 1 Oct. 2026. After this date, requests to these endpoints will return HTTP 410 Gone.

See the changelog for more details.

Features

• deprecate hcloud datacenters ... commands (#1436)

Bug Fixes

• cmd: Change tense for deletion of active context (#1412)

Datacenters commands are now deprecated

The hcloud datacenters list and hcloud datacenters describe commands are now deprecated.

The endpoints GET /v1/datacenters and GET /v1/datacenters/{id} are now deprecated and will be removed after 1 Oct. 2026. After this date, requests to these endpoints will return HTTP 410 Gone.

See the changelog for more details.

Features

• deprecate hcloud datacenters ... commands (#1436)

Bug Fixes

• cmd: Change tense for deletion of active context (#1412)

Load Balancer HTTP Services now support TimeoutIdle

A timeout for HTTP connections can now be set with --http-timeout-idle while creating or updating Load Balancer services.

See the changelog for more information.

Features

• load-balancer: support --http-timeout-idle flag (#1394)

Load Balancer HTTP Services now support TimeoutIdle

A timeout for HTTP connections can now be set with --http-timeout-idle while creating or updating Load Balancer services.

See the changelog for more information.

Features

• load-balancer: support --http-timeout-idle flag (#1394)

Bug Fixes

• apple's signing and notarizing release pipeline

Bug Fixes

• apple's signing and notarizing release pipeline

Primary IPs assignee_type behavior change

When creating a Primary IP with the primary-ip command, the --assignee-type flag will be required together with the --assignee-id flag. Using the default value (server) for the --assignee-type flag is deprecated. Consider explicitly setting the --assignee-type flag.

As of 1 August 2026, the behavior of the Primary IP assignee_type property will change, and will return unassigned when the Primary IP is not assigned (when assignee_id is null). The goal is to eventually assign Primary IPs to other resource types, not only to server.

See the changelog for more details.

In addition, the Primary IP request body assignee_type property of the operation POST /v1/primary_ips is now optional. Primary IPs created without assignee_type return server until 1 August 2026, after this date, its value will be unassigned.

See the changelog for more details.

Features

• primary-ip: --assignee-type is optional when creating a Primary IP (#1395)

Primary IPs assignee_type behavior change

When creating a Primary IP with the primary-ip command, the --assignee-type flag will be required together with the --assignee-id flag. Using the default value (server) for the --assignee-type flag is deprecated. Consider explicitly setting the --assignee-type flag.

As of 1 August 2026, the behavior of the Primary IP assignee_type property will change, and will return unassigned when the Primary IP is not assigned (when assignee_id is null). The goal is to eventually assign Primary IPs to other resource types, not only to server.

See the changelog for more details.

In addition, the Primary IP request body assignee_type property of the operation POST /v1/primary_ips is now optional. Primary IPs created without assignee_type return server until 1 August 2026, after this date, its value will be unassigned.

See the changelog for more details.

Features

• primary-ip: --assignee-type is optional when creating a Primary IP (#1395)

Available and recommended Server Types have been moved

• The Server Types list in hcloud datacenter describe is deprecated and will not be displayed anymore after 2026-10-01. The two commands below should be used for this purpose instead.
• hcloud server-type describe now shows an Available and Recommended value for each location.
• hcloud server-type list now has additional columns location_available and location_recommended.

See the changelog for more details.

Features

• datacenter, server-type: move available and recommended to server_type (#1384)

Available and recommended Server Types have been moved

• The Server Types list in hcloud datacenter describe is deprecated and will not be displayed anymore after 2026-10-01. The two commands below should be used for this purpose instead.
• hcloud server-type describe now shows an Available and Recommended value for each location.
• hcloud server-type list now has additional columns location_available and location_recommended.

See the changelog for more details.

Features

• datacenter, server-type: move available and recommended to server_type (#1384)

Bug Fixes

• invalid goreleaser artifacts name for signing step (#1380)

Bug Fixes

• invalid goreleaser artifacts name for signing step (#1380)

Bug Fixes

• server-type: do not print locations that are unavailable (after deprecation) (#1369)
• long version info not displayed correctly in release builds (#1374)
• only generate signature for checksums.txt release asset (#1366)

Bug Fixes

• server-type: do not print locations that are unavailable (after deprecation) (#1369)
• long version info not displayed correctly in release builds (#1374)
• only generate signature for checksums.txt release asset (#1366)

Features

• build .deb and .rpm release files (#1311)
• primary-ip: new flag to specify assignee-type on primary-ip create (#1348)
• increase default poll interval for long running actions (#1364)
• server-type: add location to list table default columns (#1340)
• server-type: remove storage_type from list table default columns (#1340)
• allow listing contexts as json/yaml (#1352)
• add --long flag to version command (#1353)

Bug Fixes

• suppress trailing spaces in tables (#1355)

Features

• build .deb and .rpm release files (#1311)
• primary-ip: new flag to specify assignee-type on primary-ip create (#1348)
• increase default poll interval for long running actions (#1364)
• server-type: add location to list table default columns (#1340)
• server-type: remove storage_type from list table default columns (#1340)
• allow listing contexts as json/yaml (#1352)
• add --long flag to version command (#1353)

Bug Fixes

• suppress trailing spaces in tables (#1355)

Storage Boxes support is now generally available

The experimental phase for Storage Boxes is over, and Storage Boxes support is now generally available.

Features

• Storage Box support no longer experimental (#1267)
• server: allow specifying user-data for rebuild (#1319)

Storage Boxes support is now generally available

The experimental phase for Storage Boxes is over, and Storage Boxes support is now generally available.

Features

• Storage Box support no longer experimental (#1267)
• server: allow specifying user-data for rebuild (#1319)

Storage Box Subaccounts are no longer identified by username

Storage Box Subaccounts now have a name property, allowing users to specify custom names for their Subaccounts.

More importantly, Storage Box Subaccounts (<subaccount>) are now identified by id or name, instead of by id or username.

 hcloud storage-box subaccount describe <storage-box> <subaccount>
-hcloud storage-box subaccount describe my-storage-box u1337-sub1
+hcloud storage-box subaccount describe my-storage-box my-subaccount

Existing Subaccounts have been updated to use their username as name value.

See our changelog for more details.

Features

• table: mark columns as deprecated and show warning (#1300)
• server: deprecate datacenter column (#1301)
• storage-box: add name property to subaccounts (#1315)

Deprecation of datacenter attribute for Primary IPs and Servers

The datacenter attribute is deprecated in the Primary IPs and Servers API resources and will be removed after 1 July 2026. See https://docs.hetzner.cloud/changelog#2025-12-16-phasing-out-datacenters for more details.

The location attribute already exists for Servers, and was added for Primary IPs.

Therefor the datacenter attribute is deprecated in favor of the location attribute in the following commands:

• hcloud server create
• hcloud server describe
• hcloud server list
• hcloud primary-ip create
• hcloud primary-ip describe
• hcloud primary-ip list

In list commands, the datacenter columns is not longer shown by default, and is replaced with the location column.

Features

• server,primary-ip: deprecate datacenter (#1278)

Features

• firewall: add list columns for labels, created and age (#1239)
• drop builds for windows armv6 and armv7 (32 bit) (#1246)
• context: allow creation in non-interactive tty (#1252)

DNS API is now generally available

The DNS API is now generally available, as well as support for features in this project that are related to the DNS API.

To migrate existing zones to the new DNS API, see the DNS migration guide.

See the changelog for more details.

Features

• DNS support is now generally available (#1234)

Features

• format user provided TXT records when not quoted (#1208)

Bug Fixes

• more readable default time format (#1197)
• iso: broken --type flag in list command (#1221)
• Storage Boxes not listed in hcloud all list (#1222)
• consistent tab spacing in describe commands (#1216)
• filepaths not correctly resolved on Windows (#1229)

Storage Box API Experimental

This release adds support for the Storage Box API.

The Storage Box integration will be introduced as an experimental feature. This experimental phase is expected to last until 21 November 2025. During this period, upcoming minor releases of the project may include breaking changes to features related to the Storage Box API. You can find out the current state of this in #1202.

This release includes all changes from the recent Storage Box API changelog entry.

Examples

hcloud storage-box create \
    --name backups \
    --type bx11 \
    --location fsn1 \
    --password "$PASSWORD" \
    --enable-ssh \
    --reachable-externally

hcloud storage-box enable-snapshot-plan backups \
    --max-snapshots 10 \
    --minute 0 \
    --hour 2

Features

• server,load-balancer: add --ip-range argument to attach-to-network commands (#1164)
• add support for Storage Boxes (#1118)

Bug Fixes

• list commands print null instead of [] in JSON mode (#1191)
• outdated JSON output after creating resources (#1194)
• formatting of server-type describe output (#1196)

DNS API Beta

This release adds support for the new DNS API.

The DNS API is currently in beta, which will likely end on 10 November 2025. After the beta ended, it will no longer be possible to create new zones in the old DNS system. See the DNS Beta FAQ for more details.

Future minor releases of this project may include breaking changes for features that are related to the DNS API.

See the DNS API Beta changelog for more details.

Examples

hcloud zone create \
    --name example.com \
    --mode primary \
    --label key=value

hcloud zone rrset create example.com \
    --name @ \
    --type A \
    --record 201.180.75.2

Features

• support the new DNS API (#1182)

Server Types now depend on Locations.

• We added a new locations property to the Server Types resource. The new property defines a list of supported Locations and additional per Locations details such as deprecations information.

• We deprecated the deprecation property from the Server Types resource. The property will gradually be phased out as per Locations deprecations are being announced. Please use the new per Locations deprecation information instead.

See our changelog for more details.

Features

• add category property to server type (#1150)
• per location server types (#1166)

Features

• improve error formatting (#1080)
• add plural command aliases (#1087)
• context: allow renaming contexts (#1115)
• firewall: display applied to resources when using label selector (#1082)
• highlight experimental commands (#1103)

Bug Fixes

• do not indent last empty line (#1112)
• iso: describe command suggests location names (#1113)
• segmentation fault possible when creating servers or load balancers (#1137)
• primary-ip: only suggest applicable primary IPs (#1114)

Features

• load-balancer: allow specifying network on create (#1013)
• context: add unset commmand (#1017)
• publish image to Docker Hub (#1043)

Bug Fixes

• allow getting resources with number as name
• some list flags are not correctly parsed (#987)
• load-balancer: allow certificate names in addition to IDs when creating/updating (#1026)
• config option flags sometimes not parsed correctly (#1025)

Bug Fixes

• docker publish not working

Features

• load-balancer: allow specifying network on create (#1013)
• context: add unset commmand (#1017)
• publish image to Docker Hub (#1043)

Bug Fixes

• allow getting resources with number as name
• some list flags are not correctly parsed (#987)
• load-balancer: allow certificate names in addition to IDs when creating/updating (#1026)
• config option flags sometimes not parsed correctly (#1025)

Features

• certificate: allow adding labels during create (#949)

Bug Fixes

• display $ when the currency is USD (#933)
• network: missing load_balancers property in schema