The [Runtime] section of mkosi.conf sets up mkosi vm for testing: it passes the setup credentials (mkosi.credentials/agent.ssh-key prints your own ssh keys), forwards ssh to port 2222 and adds the serial console, since systemd-stub ignores the console= mkosi passes under Secure Boot. Untested: in a container without systemd, mkosi vm hangs before qemu starts, because it can't create a systemd scope. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
155 lines
5.4 KiB
Plaintext
155 lines
5.4 KiB
Plaintext
# Agent image
|
|
#
|
|
# A Fedora VM image that runs Claude Code in the background. mkosi.extra/ is
|
|
# copied to /, mkosi.repart/ defines the disk and mkosi.sandbox/ adds the
|
|
# Claude Code package repository. The root filesystem, /etc included, is
|
|
# read-only and replaced whole by updates. All state lives on /var. Claude
|
|
# can't change the OS, so it runs its tools in containers.
|
|
|
|
[Distribution]
|
|
Distribution=fedora
|
|
Release=45
|
|
|
|
[Output]
|
|
Format=disk
|
|
ImageId=agent
|
|
OutputDirectory=mkosi.output
|
|
SplitArtifacts=uki,partitions
|
|
# Lists the packages and versions in the image, to tell which builds a CVE
|
|
# affects. .gitea/workflows/os.yml publishes it with the image.
|
|
ManifestFormat=json
|
|
|
|
[Content]
|
|
Bootable=yes
|
|
Bootloader=systemd-boot
|
|
# - kernel-core no drivers or firmware beyond what VMs need
|
|
# - systemd-container systemd-pull, which systemd-sysupdate downloads by
|
|
# - gnupg2 checks the signature of updates
|
|
# - util-linux, shadow-utils console login, setup, newuidmap for rootless podman
|
|
# - systemd-pam login sessions: Claude's user manager and its
|
|
# D-Bus, which rootless podman needs
|
|
# - openssh-server ssh login for the user (keys only)
|
|
# - zram-generator-defaults compressed swap in RAM
|
|
# - podman, podman-docker containers for Claude's toolchains (also as docker)
|
|
# - claude-code from mkosi.sandbox/etc/yum.repos.d
|
|
# - git-core, openssh-clients Claude Code uses git and pushes over ssh
|
|
# - the rest basic command-line tools Claude uses on the host
|
|
Packages=
|
|
kernel-core
|
|
systemd
|
|
dbus-broker
|
|
systemd-udev
|
|
systemd-networkd
|
|
systemd-resolved
|
|
systemd-container
|
|
gnupg2
|
|
systemd-boot-unsigned
|
|
util-linux
|
|
shadow-utils
|
|
systemd-pam
|
|
openssh-server
|
|
zram-generator-defaults
|
|
podman
|
|
podman-docker
|
|
claude-code
|
|
git-core
|
|
openssh-clients
|
|
curl
|
|
tar
|
|
gzip
|
|
xz
|
|
zstd
|
|
diffutils
|
|
findutils
|
|
procps-ng
|
|
iproute
|
|
WithDocs=no
|
|
Locale=C.UTF-8
|
|
# Name UKIs the way systemd-sysupdate names the ones it installs.
|
|
UnifiedKernelImageFormat=%i_%v
|
|
# - console= show the console on screen and on the serial port
|
|
# - systemd.machine_id= take the machine ID from the VM's firmware;
|
|
# mkosi.extra/etc/machine-id is empty, so no boot
|
|
# counts as the first
|
|
# - systemd.firstboot=no agent-setup asks its own questions
|
|
# - damon_reclaim.* free memory unused for an hour (min_age is in µs),
|
|
# so the host can take it back through virtio-balloon
|
|
# free page reporting. The watermarks make it run
|
|
# however much memory is free.
|
|
KernelCommandLine=
|
|
console=tty0
|
|
console=ttyS0,115200n8
|
|
quiet
|
|
systemd.machine_id=firmware
|
|
systemd.firstboot=no
|
|
damon_reclaim.enabled=Y
|
|
damon_reclaim.min_age=3600000000
|
|
damon_reclaim.wmarks_high=1000
|
|
damon_reclaim.wmarks_mid=999
|
|
damon_reclaim.wmarks_low=0
|
|
# The initrd only needs to find and mount the disks of a VM.
|
|
KernelInitrdModules=
|
|
virtio_blk
|
|
virtio_scsi
|
|
sd_mod
|
|
nvme
|
|
dm-verity
|
|
erofs
|
|
ext4
|
|
# All modules but the hardware drivers, then the drivers a VM needs (disks,
|
|
# network, screen) and those of rootless podman's networks (pasta). The last
|
|
# matching line wins. Keyboard, USB and a basic screen are built into the
|
|
# kernel.
|
|
KernelModules=
|
|
/*
|
|
-/drivers/*
|
|
/drivers/virtio/*
|
|
/drivers/block/*
|
|
/drivers/md/*
|
|
nvme
|
|
virtio_scsi
|
|
sd_mod
|
|
virtio_net
|
|
qemu_fw_cfg
|
|
bochs
|
|
virtio-gpu
|
|
veth
|
|
tun
|
|
# - System.map only for debugging the kernel
|
|
# - udev hwdb hardware names and quirks, nothing a VM needs
|
|
# - homed, userdbd, unused services
|
|
# nsresourced
|
|
# - sshd-keygen sshd uses one host key, kept on /var
|
|
# (mkosi.extra/etc/ssh/sshd_config.d)
|
|
RemoveFiles=
|
|
/usr/lib/modules/*/System.map
|
|
/usr/lib/udev/hwdb.bin
|
|
/usr/lib/udev/hwdb.d
|
|
/usr/lib/systemd/system/systemd-homed*
|
|
/usr/lib/systemd/system/systemd-userdbd.*
|
|
/usr/lib/systemd/system/systemd-nsresourced.*
|
|
/usr/lib/systemd/system/sshd-keygen*
|
|
|
|
[Validation]
|
|
# Sign systemd-boot and the UKI for Secure Boot, and put our keys on the ESP.
|
|
# systemd-boot enrolls them at first boot if the firmware is in setup mode (no
|
|
# keys enrolled; in Proxmox, an EFI disk without pre-enrolled keys).
|
|
# mkosi.key is the SECUREBOOT_KEY secret, which .gitea/workflows/os.yml writes.
|
|
SecureBoot=yes
|
|
SecureBootKey=mkosi.key
|
|
SecureBootCertificate=mkosi.crt
|
|
|
|
[Runtime]
|
|
# For testing with mkosi vm. It does the setup itself (the agent.* credentials,
|
|
# mkosi.extra/usr/libexec/agent-setup). Its console is hvc0, which the UKI
|
|
# doesn't use: with Secure Boot, systemd-stub ignores the console= mkosi
|
|
# passes. So the serial port joins that console, and replaces mkosi's network
|
|
# to forward ssh to port 2222. Ephemeral boots a copy, so test runs don't
|
|
# change the built image.
|
|
Ephemeral=yes
|
|
RAM=8G
|
|
RuntimeSize=40G
|
|
RuntimeNetwork=none
|
|
QemuArgs=-serial chardev:console -nic user,model=virtio-net-pci,hostfwd=tcp::2222-:22
|
|
Credentials=agent.password=test agent.hostname=agent-test mkosi.credentials/
|