Proxima¶

Proxima is the build and CI host — a Proxmox guest running bootc, Cockpit, Tailscale, a self-hosted GitHub Actions runner, and the full buildah/skopeo/qemu toolchain.

Prerequisites¶

• Proxmox VE host (7.x or 8.x)
• At least 8 GB RAM and 4 cores for the guest
• Network bridge configured (vmbr0 or equivalent)

Create the VM and import the disk¶

Download the latest Proxima qcow2 image, then:

qm create 9000 --name proxima --memory 8192 --cores 4 \
  --net0 virtio,bridge=vmbr0

qm importdisk 9000 proxima.qcow2 local-lvm

qm set 9000 --scsi0 local-lvm:vm-9000-disk-0 \
  --boot order=scsi0 \
  --serial0 socket

The --serial0 socket line wires up the serial console so qm terminal works.

First boot¶

1. Start the VM: qm start 9000
2. Open the serial console: qm terminal 9000
3. Log in (default user and credentials TBD).

Post-install¶

Tailscale¶

sudo tailscale up

Cockpit¶

Cockpit is available on port 9090:

https://<proxima-ip>:9090

GitHub Actions runner¶

The self-hosted runner is deployed as a Podman quadlet. To configure it:

1. Go to your GitHub repo → Settings → Actions → Runners → New self-hosted runner.
2. Copy the registration token.
3. Edit the runner config (details TBD — quadlet environment file).

Updates¶

sudo bootc upgrade
sudo systemctl reboot

To roll back a bad update:

sudo bootc rollback
sudo systemctl reboot

What's included¶

Troubleshooting¶

TODO — common issues and fixes will be added as they come up.