Proxmox VE Auto Installer ISO Generator

This project provides a simple script that generates a Proxmox VE automatic installer ISO file described at Automated Installation and Install Proxmox VE of the official Proxmox Wiki. This script utilizes containers as build environments so it does not bloat your system with packages and can be run everywhere, as well as in CI pipelines.

Configuration

This repository contains a default configuration. You can provide a custom configuration file in a valid Answer File Format. If you want to overwrite the default configuration, you need to mount your Answer File at /installer/answer.toml when running the conainer.

Building the container for generating the ISO

docker build -t proxmox-auto .

Run

Place your Proxmox VE ISO in your current working directory or let the auto downloader download the latest version of Proxmox VE.

The container needs to be run with elevated permissions to extract pve-installer.squashfs and patch the installer to allow installation on eMMC drives.

# default configuration
docker run -v $(pwd):/installer/iso --privileged proxmox-auto
# custom configuration
docker run -v $(pwd):/installer/iso -v /installer/answer.toml:/path/to/custom/answer --privileged proxmox-auto

eMMC Installation Patch

Proxmox does not allow installation on eMMC disks by default due to performance and reliablity reasons, but some single board computers (SBCs) ship with eMMC storage that would be sufficient for most educationital and home use. Some popular options are the ZimaBoard and ZimaBlade by IceWhale Technology.

This project provides an easy way to build a patched Proxmox VE auto installer ISO that allows the installation on eMMC storage. Recommended disk-setup settings to the Answer File are:

Zimablade & Zimaboard:

[disk-setup]
filesystem = "zfs"
zfs.raid = "raid0"
disk_list = ["mmcblk0"]

Disclaimer

This is an unofficial project for educational purposes. This project is not affiliated with or endorsed by Proxmox and Proxmox Server Solutions GmbH.