Fedora Workstation

Ansible setup of my workstation.

Motivation

I am using Fedora Silverblue for my workstation. I have some customizations applied and software installed, that I rely on. To ensure that everything works after a re-installation and to document my setup, I want to use Ansible.

Description

The Ansible playbook will install and configure various software. Most of the automation can be configured very easily and should be self-explanatory. Nevertheless, the following section will provide a feature overview.

The original author also wrote an article in his blog about his setup, which my setup is based on.

Screenshots

Just some impressions.

Features

The below software and configurations are examples for the included software. I am heavily relying on Flatpaks from Flathub and some binary downloads.

Firefox
GIMP
micro

And many more.

Support

The repository is meant for my own set of hardware and the hardware is mostly working out of the box, without additional drivers or tooling. Therefore, it may work for your setup, too. Nevertheless, there is no guarentee, though.

My setup consists of:

Fedora Silverblue

Usage

The playbook is designed to be used on a localhost via ansible-playbook or ansible-pull. This section describes which steps are needed to work with the same tools, I do.

Requirements

You will need a Fedora Workstation installation with installed Ansible. I don't do any partitioning or network configuration in the playbook, so this is up to you. Nevertheless, for me it works best, when using a simple Fedora Workstation setup with btrfs. One may say ... "default". ❤️

Install

This section describes how to install and get the playbook going.

Ansible

Before starting to use the playbook, you need to ensure that Ansible is installed in a recent version.

Since Fedora 36, you can install Ansible Core 2.12/Ansible 5.

# Install ansible via rpm-ostree
$ sudo rpm-ostree install ansible

Playbook

Afterwards, you can download the desired release from the release page and store it in a location, that suits your needs.

# Download a tag/release
$ https://github.com/evfool/fedora-workstation/archive/refs/tags/<tag_name>.zip

If you want to use git, help to develop or change to a tag/branch on the fly, you can clone the repository instead.

# Clone the repository with a given tag
$ git clone https://github.com/evfool/fedora-workstation.git

# Checkout the desired tag
$ git checkout <tag_name>

Roles and Collections

Before running the actual playboook, it is needed to install required roles and collections. This can be done in two simple commands.

# Install collections
$ ansible-galaxy collection install -r ansible/requirements.yml

# Install roles
$ ansible-galaxy role install -r ansible/requirements.yml

This will also install the upstream collection whiletruedoio.desktop which is maintained by me, too.

Tuning variables

You can find a manifest.yml in the repository. There you will find multiple options to configure your desired setup. For now, this is quite minimal, but you can also check out the defaults/main.yml of each role and change the variables via the manifest.yml.

The first run

Now you are ready to execute the playbook. Be aware, that this will run for quite some time, remove packages, download packages and configure a couple of services.

# Check run and show diffs
$ ansible-playbook --check --diff -K ansible/playbooks/configure.yml

# Execute the playbook
$ ansible-playbook -K ansible/playbooks/configure.yml

It is a good idea to restart your machine afterwards to ensure that everything is working and configured as expected.

Contribute

The dotfiles are intended to be used by me (evfool), forked from Daniel Shier's awesome work (https://github.com/dschier-wtd/fedora-workstation). Feel free to use/fork/enhance them or opening issues on the original project to give the author an idea what may be added in future versions.

License

Except otherwise noted, all work is licensed under a BSD-3-Clause License.