Skip to content

CasadoraOS Docs

CasadoraOS is a set of bootc images for home infrastructure. Each image is a Containerfile — small, auditable, and forkable.

Choose an image below for its install guide and configuration reference, or read Building your own image if you want to create a custom target.

Images

Image Architecture Role Status
Orion aarch64 Raspberry Pi services host Stable
Proxima x86_64 Proxmox CI/build guest Beta

Quick start

Orion (Raspberry Pi)

sudo bootc switch ghcr.io/CasadoraTech/casadora-os/orion:latest
sudo systemctl reboot

Proxima (Proxmox)

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

Common post-install steps

Regardless of which image you're running:

  1. Enroll in Tailscale — sudo tailscale up
  2. Access Cockpit — navigate to https://<host>:9090
  3. Manage services — user quadlets live in ~/.config/containers/systemd/