Image

Source: src/Hetzner/Image.ts

A Hetzner Cloud custom Image — a snapshot (or backup) of a Server’s disk. Stock system/app Images (ubuntu-24.04, …) are Catalog lookups via Hetzner.findImage, not this resource.

Snapshots are created with POST /servers/{id}/actions/create_image and billed per GB. Description, labels, delete protection, and backup→snapshot conversion update in place. Changing the source Server replaces the Image.

Creating a Snapshot

Snapshot from a Server

const server = yield* Hetzner.Server("web", {
  serverType: "cx22",
  image: "ubuntu-24.04",
  location: "nbg1",
});
const image = yield* Hetzner.Image("golden", {
  server,
  description: "golden-web",
  labels: { role: "golden" },
});

Snapshot with generated description

const image = yield* Hetzner.Image("backup", {
  server: { serverId: 42 },
});

Updating a Snapshot

const image = yield* Hetzner.Image("golden", {
  server,
  description: "golden-web-v2",
  labels: { role: "golden", env: "prod" },
  deleteProtection: true,
});