Create a VM template from the latest Debian release with settings appropriate for the Lokschuppen/Jachthafen Proxmox cluster
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-07-09 22:31:58 +02:00
.gitignore Ignore downloaded files 2024-06-22 08:23:56 -04:00
authorized_keys Keep downloads around in local dir 2026-02-21 11:35:48 +01:00
build-proxmox-template Always operate relative to script dir 2026-02-21 11:41:53 +01:00
build-ubuntu-template WIP ubuntu runner images 2026-07-09 22:31:58 +02:00
forgejo-runner-once.sh WIP ubuntu runner images 2026-07-09 22:31:58 +02:00
install-runner.sh WIP ubuntu runner images 2026-07-09 22:31:58 +02:00
README.md sshd listens on the default port 2026-02-21 10:37:58 +00:00

Create a VM template from the latest Debian release with settings appropriate for the Lokschuppen/Jachthafen Proxmox cluster

Prerequisites

The script uses the package libguestfs-tools' virt-builder to download and customize a Debian image, and then add it as a template to Proxmox.

Building the Template

Configuration Options

Verify that the settings at the beginning of the script are suitable to the cluster you want to create the template from.

Variable Default Description
VMID 9023 ID the template should have in Proxmox
STORAGE local-zfs Pool the disks should be created in
OS debian-12 virt-builder name of the OS to install
NAME eisenboot-${OS}-tmpl-$(date -u +%Y-%m-%d) name of the template
BRIDGE vmbr125 name of the bridge to use and any parameters needed, like the VLAN tag

User Account, sshd, and authorized_keys

cloud-init will create a user eisenboot, by default with a locked password, and authorized keys initialized. Password-less sudo is configured, so you can run commands as root.

authorized_keys is maintained in this directory.

Run the Script

sudo ./build-proxmox-template

Cloning the Template

Please use "Full Clone" when creating a VM based on this template. Using Linked Clone means that the template's disk cannot be recreated since the linked clones need it. This means that the script cannot update the template.

Disk Size

The installed cloud-guest-utils will automatically increase the root filesystem when you increase the size of the root disk. You will need to reboot the VM for the resize to take place. You can increase the size of the disk right after cloning and before starting the VM for the first time.

Root Password

The root account is disabled. Use the eisenboot account.