[email protected]

How-to · Proxmox

Proxmox on Hetzner: ZFS RAID1 Single-Node Setup with Auto-Install Script

Editorial note: Versions, commands and prices may change. Please verify critical steps independently before production use. This guide does not replace individual professional, legal or tax advice.

Run Proxmox on Hetzner professionally? WZ-IT handles setup, network design, operations and support for your Proxmox infrastructure. To the service page →

This post covers a reproducible installation of Proxmox VE on a Hetzner Dedicated Server as a single node with ZFS Mirror (RAID1) - without a KVM console, by booting the server into the rescue system and letting a script automate the installation. The project lists AX, EX and SX as compatible series and AX-102 as its primary test model.


What You'll Get

  • Freshly installed Proxmox VE (automated via ISO + auto-install)
  • Root filesystem on ZFS (Mirror/RAID1)
  • Typical Proxmox network setup:
    • vmbr0 = Public Bridge (IPv4/IPv6)
    • vmbr1 = Private Bridge with NAT/Masquerading (practical for internal networks/LXCs/VMs)
  • Proxmox Web GUI accessible at https://<IP>:8006

Important Notes (Please Read)

  • Warning: Data Loss. This installation is intended for fresh installs and will overwrite the system on the disks (typical reinstall behavior).
  • This is a third-party script (ariadata/proxmox-hetzner). Read through it before running and only use it if you agree that it modifies system and network files as well as APT sources.
  • Hetzner's network configuration is somewhat "special" (routing/gateway requirements). If you change things later, refer to Hetzner guidelines.

  • As of October 2026: The project uses the MIT license and primarily reports tests on AX-102. The source selects the latest ISO for download; an existing pve.iso is reused. Review script and ISO before running as root.

WZ-IT offers maintenance and support for updates, monitoring and backups.

Prerequisites

Before choosing a server, check hardware and sizing and compare hosting providers.

  • Hetzner Dedicated Server of the AX, EX or SX series (the project reports tests mainly on AX-102)
  • Access to Hetzner Robot (or Hetzner Cloud Rescue, depending on product)
  • SSH Client (Linux/macOS Terminal or Windows PowerShell/WSL)
  • Optional: SSH key registered in Robot (more convenient for rescue)

Table of Contents


Step 1: Activate Rescue System (Hetzner Robot)

  1. In Hetzner Robot: Servers → select your server → Rescue
  2. Select Linux / 64-bit (public key optional) and activate rescue
  3. Then in the Reset tab, trigger a Hardware Reset
  4. SSH into the rescue system as root (password is shown in Robot)
SSH Login to Hetzner Rescue System

Step 2: Start Installation via Script

In the rescue system as root:

curl -fSLo pve-install.sh https://raw.githubusercontent.com/ariadata/proxmox-hetzner/main/scripts/pve-install.sh
less pve-install.sh

Before running, read the entire script, including files it downloads. To pin a revision, replace main in the download URL with the full commit hash of the selected revision; if releases or tags exist, select their corresponding commit. Only then execute the local file:

bash pve-install.sh

The project describes the process as an automated installation without console (ISO is downloaded, auto-install configuration is created, ZFS RAID1 is set up, network IPv4/IPv6 is configured, hostname/FQDN etc.).

What the script interactively asks:

  • Network interface (e.g., eno1)
  • Hostname & FQDN
  • Timezone & email
  • Private subnet (for vmbr1/NAT)
  • New root password
Proxmox Hetzner Script - Network Wizard Proxmox Hetzner Script - Summary and Start

After confirmation, the automatic installation begins:

Proxmox Installation Running

Step 3: What the Script Does Technically (Brief and Transparent)

So you know what's happening, here are the key components:

1) Proxmox ISO + Auto-Install

The script downloads a Proxmox VE ISO (automatically "latest") and creates an auto-install ISO via the Proxmox auto-install assistant.

2) ZFS Mirror (RAID1)

The auto-install answer file sets:

  • filesystem = "zfs"
  • zfs.raid = "raid1"
  • Installation on two disks (as vda/vdb in the installer)

Proxmox has supported ZFS as a root option for years (no manual module building required).

The storage options are explained in ZFS, Ceph or LVM compared.

3) Installation via QEMU in Rescue

The Proxmox installation is booted in a QEMU VM within the rescue system, installing directly to the server disks (virtually mapped as vda/vdb).

4) Networking with one public IP: vmbr0 and vmbr1 with NAT

After installation, the script briefly boots the freshly installed environment with SSH port forwarding, copies prepared template files over, and sets up:

  • /etc/network/interfaces with
    • vmbr0 (Public Bridge, IPv4 + IPv6)
    • vmbr1 (Private Bridge) plus NAT/MASQUERADE iptables rules
  • IP forwarding via sysctl (net.ipv4.ip_forward=1, net.ipv6.conf.all.forwarding=1)

This is practical when you want to run VMs/LXCs "internally" first without immediately routing public IPs.


Step 4: Reboot and Log into Proxmox

After completion, the script asks if it should reboot:

Proxmox Installation Complete - Confirm Reboot

After that, your server boots into the installed Proxmox.

Access the web interface at:

  • https://<your-server-ip>:8006

Login:

  • User: root
  • Password: the password you set (in the script/installer)
Proxmox VE Login Screen

Quick Checks After Login

1. Check ZFS Pool (Shell on Node)

zpool status
zfs list

You should see a mirror pool (ZFS RAID1). The ZFS root setup is the core of this approach.

2. Check Network Bridges

  • Datacenter → <Node> → System → Network

You should see vmbr0 and vmbr1 (Public/Private).


Optional: Next Steps

For subsequent steps, see the guides to running without a subscription and encrypted backups on Hetzner.


Read next:VMware to Proxmox migration · Setting up Proxmox Backup Server · Private cloud for SMEs

Sources


Further Guides

For public connectivity and private guests: Proxmox on Hetzner with one IP and a firewall VM.


Have questions about Proxmox, virtualization, or cluster setups on Hetzner? We support you with installation, operations, and optimization. Schedule a consultation now

Rather have it operated?

You'd rather not run Proxmox yourself? WZ-IT handles setup, operations and maintenance - privacy-focused from Germany.

Enquiry

Build, migrate, or operate Proxmox

We design and maintain Proxmox environments from a single node to an HA cluster, including migration, storage, backup, and ongoing operations.

  • Straight with Timo and Robin - no sales team, no pitch
  • A professional assessment of your situation
  • Concrete next steps for infrastructure, software or AI

The conversation is free and non-binding.

WZ-IT provided very competent support in implementing our server and virtualization infrastructure. As part of the project, a Proxmox-based virtualization environment was set up along with a virtual machine for our application systems. Additionally, a structured backup concept was implemented. A particular focus was on security: the setup of a VPN tunnel and the clean implementation of encryption and access concepts were professionally executed. The structured consulting as well as the reliable and swift implementation deserve special mention. We are very satisfied with the services provided and are happy to recommend WZ-IT.
John HellmerichsManaging Director, AInergy GmbH
Timo and Robin, founders of WZ-IT

Build, migrate, or operate Proxmox

WZ-IT provided very competent support in implementing our server and virtualization infrastructure. As part of the project, a Proxmox-based virtualization environment was set up along with a virtual machine for our application systems. Additionally, a structured backup concept was implemented. A particular focus was on security: the setup of a VPN tunnel and the clean implementation of encryption and access concepts were professionally executed. The structured consulting as well as the reliable and swift implementation deserve special mention. We are very satisfied with the services provided and are happy to recommend WZ-IT.
John HellmerichsManaging Director, AInergy GmbH

Frequently Asked Questions

Answers to the most important questions

Knowledge

More on Proxmox

1 more articles are in progress.

All Proxmox articles

Companies worldwide trust WZ-IT

  • Stadtwerke Brühl
  • DGHO e.V.
  • solarwerkstatt berlin
  • Krüger Dirndl
  • ABCO Water Systems
  • Golem.de
  • EVADXB
  • nextGYM
  • AInergy
  • ml&s
  • Odiseo Solutions
  • Annota
  • ARGE
  • SweetConnect GmbH
  • Aphy AG
  • CORGOS
  • Rekorder
  • SolidProof
  • Yonju
  • Keymate
  • Paritel
  • Mr. Clipart
  • Millenium
  • Negosh
  • Führerscheinmacher
  • BTI
  • Deutsche Gesellschaft für Datenschutz
Read client reviews