Parch Linux Cloud Images

Build and run Parch Linux virtual machine images for x86_64 QEMU/KVM.

Images

Image	Description
Cloud	Cloud-init enabled image for automated setup.
Basic	Image for interactive use.
Libvirt executor	Image with GitLab Runner and libvirt tools.

Generated images and SHA-256 checksums are saved in output/

Requirements

Arch Linux x86_64 to build images
QEMU/KVM and libvirt to run virtual machines
Terraform to provision a VM with the included configuration

Install the build dependencies with:

make install-deps

Build

Build all image variants:

make build

Build only the cloud image:

make build-cloud

Set a version explicitly if needed:

make build-cloud VERSION=20261018.1

Run

Create an SSH key if needed, then build and start the cloud VM:

ssh-keygen -t ed25519
make build-cloud
make qemu-up

Connect to the VM:

make qemu-ip
make qemu-ssh

The VM is configured with Terraform in terraform/. Adjust its settings there as needed.

Useful commands

make help       # list available commands
make qemu-plan  # preview VM changes
make qemu-down  # remove the VM
make clean      # remove generated files

Contributors

Core Developer: Amir Husayn Panahifar ahp@panahifar.ir