pulumi-hcloud

library1.38.0pypypi✓ verified 87d ago

A Pulumi provider for managing Hetzner Cloud resources (servers, volumes, networks, etc.). Current version 1.38.0. Releases follow Pulumi provider release cadence, generally monthly.

devops

pip install pulumi-hcloud

github ↗homepage ↗

INSTALL

IMPORT

SIG · PULUMI-HCLOUD

pulumi-hcloud

devopspythonv1.38.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

hcloud

✓ import pulumi_hcloud as hcloud

✗ import hcloud

The Pulumi provider uses the 'pulumi_hcloud' namespace, not the standalone 'hcloud' library.

Basic example creating a Hetzner Cloud server with Pulumi.

import pulumi import pulumi_hcloud as hcloud # Create a simple Hetzner Cloud server server = hcloud.Server( "nginx-server", server_type="cx11", image="ubuntu-20.04", location="nbg1", ) pulumi.export("server_ip", server.ipv4_address)

Debug

Known issues

breakingThe `token` argument for provider configuration was deprecated in favor of `hcloud_token` in v1.0.0. Using `token` will cause errors in newer versions.

fix

Use `hcloud_token` instead of `token` when configuring the provider.

affects: >=1.0.0

gotchaDeleting a server does not automatically delete attached volumes. Volumes must be detached and deleted separately to avoid cost.

fix

Explicitly manage volume lifecycle or detach before server deletion.

affects: all

gotchaDatacenter names (e.g., 'nbg1-dc3') are region-specific; using an incorrect datacenter may cause resource creation failure.

fix

Use location instead of datacenter unless you specifically need a particular DC. Check available datacenters via 'hcloud datacenter list'.

affects: all

Errors

Common errors & fixes

pulumi_hcloud:Index error: expected input to be of type string, got undefined

Required argument like 'server_type' or 'image' was not provided or is None.

fix

Ensure all required resource properties are provided when creating a resource.

403 Forbidden: insufficient permissions

The Hetzner Cloud API token does not have the required scopes for the operation.

fix

Provide a token with read/write access. Set `hcloud_token` in Pulumi config or environment variable.

pulumi_hcloud:Server resource '...' has a problem: context deadline exceeded

Network timeout during resource creation or update; often due to slow API response.

fix

Retry the operation. If persistent, check network connectivity or increase Pulumi's timeout settings.

Upgrade

Version history

1.38.0latest on PyPI · released May 29, 2026

Audit

Dependencies

pulumirequiredRequired core Pulumi SDK for infrastructure as code.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/pulumi/pulumi-hcloud ↗

homepagehttps://github.com/pulumi/pulumi-hcloud ↗