⚡ One-Command Template Automation

Create cloud-init
Templates on
Proxmox VE

Automate cloud-init ready template creation across 9 Linux families. No config files, no manual steps — just one command.

proxmox-shell — bash
root@pve:~# wget -qO- pvesh.com | bash
or
root@pve:~# curl -Lso- pvesh.com | bash
Run this from the Proxmox shell (not SSH) as root. Requires Proxmox VE 8.1+ on amd64.

Everything you need to build cloud-init templates fast

Built for Proxmox administrators who need repeatable, reliable template creation without manual CLI gymnastics.

📦

Instant Template Creation

Interactive menus guide you through every option. Default mode produces a ready-to-clone template in minutes.

🆔

Smart ID Management

Automatically finds the next available VM ID from 1001, skipping all existing containers and VMs.

☁️

Cloud-Init Built In

Injects cloud-init, SSH server, and qemu-guest-agent into the image offline — every template is fully configured before first boot.

⚠️

EOL Warnings

Built-in end-of-life detection warns before building templates from unsupported OS versions with no security patches.

⚙️

Default & Advanced Modes

Quick defaults for speed, or full control over CPU type, disk cache, bridge, VLAN, MTU, and MAC address.

🔒

Validation Checks

Verifies root access, PVE version, architecture, and storage availability before making any changes.

26+ versions across 9 distro families

All images are official cloud builds pulled directly from vendor-maintained CDNs.

🌀
Debian
9 · 10 · 11 · 12 · 13
🟠
Ubuntu
18.04 · 20.04 · 22.04 · 24.04
🔵
AlmaLinux
8 · 9
🟢
Rocky Linux
8 · 9
🔴
Oracle Linux
8 · 9
⚙️
CentOS
7 · 8 · Stream 8 · Stream 9
🎩
Fedora
41 · 42
🦎
openSUSE Leap
15.5 · 15.6
🏔️
Alpine Linux
3.19 · 3.20 · 3.21

From command to ready-to-clone template in minutes

1

Run one command

Paste the wget or curl one-liner into your Proxmox shell. No installation needed.

2

Choose your OS

Interactive menus let you pick the distribution, version, and either default or advanced settings.

3

Image customised

SSH, qemu-guest-agent, and cloud-init are injected into the disk image offline — before it ever touches Proxmox.

4

Template is ready

The image is imported, the VM is locked as a read-only template, and you can qm clone it instantly.

Common questions

SSH sessions can have variable timeout and TTY settings that interfere with whiptail dialog rendering. The Proxmox web console provides a stable, fully-interactive terminal that ensures menus display and respond correctly.
No. The script targets x86_64 / amd64 only. All referenced cloud images are amd64 builds. For ARM64 Proxmox support, see the asylumexp/Proxmox project.
Proxmox VE 8.1 or later. The script checks the installed PVE version at startup and exits gracefully with an explanation if the requirement is not met.
Directly from official vendor CDNs: cloud.debian.org, cloud-images.ubuntu.com, repo.almalinux.org, download.rockylinux.org, yum.oracle.com, cloud.centos.org, dl.fedoraproject.org, download.opensuse.org, and dl-cdn.alpinelinux.org. No third-party mirrors are used.
The script registers bash trap handlers for ERR, SIGINT, and SIGTERM. If creation fails, the partially created VM is automatically destroyed and the temporary working directory is cleaned up.
Yes. The entire project is MIT licensed and open source.
✓ Copied to clipboard