Skip to content

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

License

Notifications You must be signed in to change notification settings

zenxero/fedora-ansible-workstation

Repository files navigation

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 KDE 37, 38, 39, and 40

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

Table of Contents

Requirements

Bootstrapping

  1. In order to run this playbook, Ansible needs to be installed from the package repos:
sudo dnf install ansible
  1. 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.

  1. 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
  1. 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