This repository defines Podman Quadlet services for Fedora CoreOS machines.
The repository combines files from systems/common/ with files from one
machine tree. Each machine pulls and applies its state on a systemd timer.
Follow the getting-started tutorial to configure the local tools and create a machine tree.
mise bootstrap
mise run check
mise run machine:new valheim.hostname.tld
mise run machine:provision valheim-hostname-tld
mise run machine:apply --machine valheim-hostname-tld
mise run container:run --system minecraft-lan --definition prominenceProvisioning installs mise and a systemd timer on the target. Every 15 minutes,
the timer resets its checkout to origin/main and applies its machine tree.
The documentation follows the Diátaxis structure.
| Type | Use it when you need to | Documents |
|---|---|---|
| Tutorial | Learn the workflow | Get started |
| How-to guide | Complete a specific task | Add a machine, Provision a machine, Manage a local image |
| Explanation | Understand the design | Desired-state model |
| Reference | Look up exact details | Repository reference |
This repository is public. Do not store secrets in it. Manage secret values
with fnox. Keep mutable service data in /var/lib/ on each machine.
Machine trees can contain local image definitions under definitions/. The
target builds changed definitions before it applies Quadlet state.
container:run builds a definition and starts it locally with the environment,
ports, and volumes from its matching Quadlet.