Ansible playbooks for provisioning my Fedora workstations.
Previously these were Comtrya manifests; Comtrya is no longer maintained, so everything has been ported to Ansible roles.
Fedora (x86_64) only. Earlier revisions of this repo also targeted Ubuntu
and Linux Mint; all apt-based branches have been removed. Everything here
assumes dnf, RPM packaging, and Fedora package names.
# One time per machine: installs ansible-core, ansible-lint and collections
sudo ./bootstrap.sh
# Build the whole workstation (-K prompts once for your sudo password)
ansible-playbook playbooks/workstation.yml -K
# Or run a single role
ansible-playbook playbooks/podman.yml -K
# Preview without changing anything
ansible-playbook playbooks/workstation.yml -K --check --diffansible.cfg # inventory, roles_path, output formatting
bootstrap.sh # installs ansible + collections on a fresh machine
inventory.ini # [workstations] -> localhost, connection=local
group_vars/all/ # user paths (main.yml) and Zen Browser config (zen.yml)
playbooks/ # workstation.yml (everything) + one per role
roles/<role>/ # defaults/ files/ handlers/ meta/ tasks/ templates/
Roles are snake_case to satisfy ansible-lint's role-name rule.
| Role | Description |
|---|---|
bashrcd |
Ensures ~/.bashrc.d exists and is sourced by ~/.bashrc |
bottom |
Installs bottom from the latest upstream release RPM |
catppuccin_gnome_terminal |
Installs the Catppuccin GNOME Terminal profiles and defaults to Mocha |
discord |
Installs Discord from RPM Fusion nonfree |
dnf_automatic |
Applies package updates unattended on a daily timer |
git |
Installs Git |
golang |
Installs the latest Go toolchain into /usr/local/go |
jq |
Installs jq |
just |
Installs the just command runner |
nerd_fonts_hack |
Installs Hack Nerd Font and sets it as the desktop monospace font |
no_notifications |
Disables GNOME event sounds |
podman |
Installs rootless Podman and exposes a Docker-compatible socket |
rpmfusion |
Enables the RPM Fusion free and nonfree repositories |
rust |
Installs Rust via rustup and keeps toolchains updated |
sshd |
Enables and starts the OpenSSH server, and opens it in firewalld |
starship |
Installs the Starship prompt and its configuration |
task |
Installs the Task runner from Cloudsmith |
tealdeer |
Installs tealdeer and primes the tldr cache |
vim |
Installs Vim (vim-enhanced) |
vscode |
Installs Visual Studio Code from Microsoft's dnf repository |
wezterm |
Installs WezTerm and its Lua configuration |
yubikey_pam |
Opt-in YubiKey FIDO2 PIN + touch for sudo, LightDM, screen unlock, and console login, with password fallback |
zen_browser |
Installs Zen Browser to /opt/zen |
zen_browser_extensions |
Downloads extension XPIs into the Zen install |
zen_browser_policies |
Renders Zen's policies.json enterprise policy |
Declared in each role's meta/main.yml, so the single-role playbooks are
correct on their own. Ansible de-duplicates shared dependencies within a run.
starship, golang, rust, podman, zen_browser -> bashrcd
starship, wezterm -> nerd_fonts_hack
discord -> rpmfusion
zen_browser_extensions, zen_browser_policies -> zen_browser
- Docker was replaced by rootless Podman. No root daemon and no
dockergroup; thepodmanrole removes any Docker Engine packages, enablespodman.socketin the user's systemd scope, and exportsDOCKER_HOSTso Docker-API clients keep working. bashrcdis conditional. Fedora's stock~/.bashrcalready sources~/.bashrc.d, so the role only appends the loop when it is genuinely missing — otherwise every snippet would be sourced twice.- Zen policies are one template. The Comtrya version shelled out to
jqto merge two JSON files at apply time.policies.jsonis now rendered from a single template that shares thezen_extensionslist with the extensions role, so extension GUIDs and XPI filenames cannot drift apart. vscodeandtaskuse real dnf repositories instead of one-off package downloads, sodnf upgradekeeps them current.taskdeliberately does not run Cloudsmith'ssetup.rpm.sh: that script pinssslcacertto/etc/pki/tls/certs/ca-bundle.crt, a path Fedora'sca-certificatesno longer provides, so everydnftransaction failed the repo withCurl error (77). The role declares the repository itself and lets it use the system trust store. It also drops the empty-noarchand-sourcerepositories the script created.- Idempotency. Comtrya's
command.runsteps ran unconditionally; the Ansible equivalents are guarded withcreates:,statchecks, or agsettings getbeforeset. Read-only probes setcheck_mode: falseso--checkruns report accurately.
Upstream publishes no stable Fedora channel — their own Fedora instructions
point at the wezfurlong/wezterm-nightly COPR, so that is what the role uses.
Expect it to update often; builds land several times a day, and with
dnf_automatic enabled they will be applied on the daily timer.
The configuration goes to ~/.config/wezterm/wezterm.lua. WezTerm checks that
path before ~/.wezterm.lua, so an old dotfile in $HOME cannot shadow it.
WezTerm watches the file and reloads on save, so no restart is needed after the
role updates it.
dnf_automatic keeps the machine patched without prompting. On Fedora 44 this
is the dnf5 plugin (dnf5-plugin-automatic), not the old standalone
dnf-automatic; it ships /etc/dnf/automatic.conf empty and keeps its defaults
in /usr/share/dnf5/dnf5-plugins/automatic.conf, so the role writes only the
keys it changes.
Updates are downloaded and applied daily (the packaged timer fires at 06:00
with an hour of jitter, and Persistent=true catches up after a machine that
was powered off). The system is never rebooted automatically — that stays a
deliberate act. This only ever upgrades within the installed Fedora release;
it cannot start a version upgrade.
dnf-automatic.timer also exists, but it is a symlink to dnf5-automatic.timer
rather than a second timer, so systemd treats them as one unit under two names.
The role acts on the real unit; systemctl is-enabled dnf-automatic.timer
reporting alias is expected.
Results go to the journal:
journalctl -u dnf5-automatic.service
systemctl list-timers dnf5-automatic.timerSee YUBIKEY_README.md for the opt-in setup, enrollment, activation, testing, troubleshooting, and recovery commands. To read the guide in your terminal:
cat YUBIKEY_README.mdansible-lintThe repo is clean at ansible-lint's production profile.