Skip to main content
← back to extensions

@swampadmin/hetzner-cloud

v2026.01.10.0

Manage Hetzner Cloud infrastructure including servers, networks, firewalls, and load balancers.

Features

  • Server lifecycle — create, resize, rebuild, snapshot
  • Network management — VPCs, subnets, routing
  • Firewall rules — stateful rules with label selectors
  • Load balancers — HTTP/TCP with health checks

Repository

https://github.com/swamp-club/hetzner-cloud

Platforms

linux-x86_64linux-aarch64

Labels

cloudinfrastructurehetzner

Contents

models

Install

$ swamp extension pull @swampadmin/hetzner-cloud

Release Notes

New

  • Load balancer model with HTTP/TCP support, health checks, and target management
  • Server snapshot method for backup workflows
  • File outputs on server model for audit log export

Fixed

  • Network subnet creation now validates CIDR ranges

@swampadmin/hetzner-cloud/serversv1.0.0servers.ts

Global Arguments

ArgumentTypeDescription
api_tokenstringHetzner Cloud API token
regionstringData center region (e.g. fsn1, nbg1, hel1)
dry_run?booleanPreview changes without applying
createcreate operation
ArgumentTypeDescription
namestringResource display name
labels?recordKey-value labels for resource tagging
deletedelete operation
ArgumentTypeDescription
idstringResource identifier
force?booleanSkip confirmation and delete immediately
rebuildrebuild operation
ArgumentTypeDescription
namestringResource name
resizeresize operation
ArgumentTypeDescription
namestringResource name
snapshotsnapshot operation
ArgumentTypeDescription
namestringResource name

Resources

servers.state(persistent)— Managed resource state
servers.lock(ephemeral)— Concurrency lock

Files

servers.log(text/plain)— Operation audit log
servers.json(application/json)— Structured output
@swampadmin/hetzner-cloud/networksv1.0.0networks.ts

Global Arguments

ArgumentTypeDescription
api_tokenstringHetzner Cloud API token
regionstringData center region (e.g. fsn1, nbg1, hel1)
dry_run?booleanPreview changes without applying
createcreate operation
ArgumentTypeDescription
namestringResource display name
labels?recordKey-value labels for resource tagging
deletedelete operation
ArgumentTypeDescription
idstringResource identifier
force?booleanSkip confirmation and delete immediately
add_subnetadd subnet operation
ArgumentTypeDescription
namestringResource name
@swampadmin/hetzner-cloud/firewallsv1.0.0firewalls.ts

Global Arguments

ArgumentTypeDescription
api_tokenstringHetzner Cloud API token
regionstringData center region (e.g. fsn1, nbg1, hel1)
dry_run?booleanPreview changes without applying
createcreate operation
ArgumentTypeDescription
namestringResource display name
labels?recordKey-value labels for resource tagging
deletedelete operation
ArgumentTypeDescription
idstringResource identifier
force?booleanSkip confirmation and delete immediately
apply_rulesapply rules operation
ArgumentTypeDescription
namestringResource name
@swampadmin/hetzner-cloud/load-balancersv1.0.0load-balancers.ts

Global Arguments

ArgumentTypeDescription
api_tokenstringHetzner Cloud API token
regionstringData center region (e.g. fsn1, nbg1, hel1)
dry_run?booleanPreview changes without applying
createcreate operation
ArgumentTypeDescription
namestringResource display name
labels?recordKey-value labels for resource tagging
deletedelete operation
ArgumentTypeDescription
idstringResource identifier
force?booleanSkip confirmation and delete immediately
add_targetadd target operation
ArgumentTypeDescription
namestringResource name
remove_targetremove target operation
ArgumentTypeDescription
namestringResource name

Resources

load-balancers.state(persistent)— Managed resource state
load-balancers.lock(ephemeral)— Concurrency lock