zenxero / fedora-ansible-workstation

An Ansible playbook targeting Fedora that configures my workstation to my needs

Setup Fedora Workstation

This Ansible playbook will set up a basic Fedora workstation with the packages and configs that I need. This is mostly geared towards setting up the system with a gaming focus. Options to install Steam, Mangohud, Heroic Games Launcher, OBS, etc. are included. All options in the main setup-workstation.yml file are simple True/False toggles. Choose which options you want and set them to True, then save the file and then run the playbook with Ansible.

NOTE: This has only been tested against Fedora Workstation 37, 38, and 39

NOTE: This playbook is configured to run against the local host.

Table of Contents

• Requirements
• Bootstrapping
• Usage

Requirements

• Ansible Control System Requirements
• A Fedora system with the ansible and git packages installed.
• Sudo permissions to run this playbook locally

Bootstrapping

1. In order to run this playbook, Ansible needs to be installed from the package repos:

sudo dnf install ansible

2. On your local system with ansible and git installed, clone this git repo.

Usage

First, take a look at the setup-workstation.yml file. This file contains all of the options for this playbook. Pick and choose the things that you would like to enable before running the playbook. Most options are a simple "True" or "False" selection.

1. It's a good idea to run a dry-run check before you actually run the playbook to make changes to your system. To perform a dry-run, run the following command:

ansible-playbook setup-workstation.yml --check

NOTE: You will be asked for your your sudo password since this playbook needs root privileges for various tasks.

2. If there are no failures and you want to run it for real, just remove the --check from the end of the command:

ansible-playbook setup-workstation.yml

3. For verbose output, you can add up to 4 v's to the end of the command, like so:

ansible-playbook setup-workstation.yml -vvvv