Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zenxero/fedora-ansible-workstation
An Ansible playbook targeting Fedora that configures my workstation to my needs
https://github.com/zenxero/fedora-ansible-workstation
ansible ansible-playbook fedora fedora-workstation fedora37 fedora38 fedora39 fedora40 linux-gaming workstation workstation-setup
Last synced: 3 months ago
JSON representation
An Ansible playbook targeting Fedora that configures my workstation to my needs
- Host: GitHub
- URL: https://github.com/zenxero/fedora-ansible-workstation
- Owner: zenxero
- License: mit
- Created: 2023-02-03T01:44:18.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-18T22:23:18.000Z (5 months ago)
- Last Synced: 2024-09-30T05:05:02.002Z (3 months ago)
- Topics: ansible, ansible-playbook, fedora, fedora-workstation, fedora37, fedora38, fedora39, fedora40, linux-gaming, workstation, workstation-setup
- Language: Jinja
- Homepage:
- Size: 88.9 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](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](#requirements)
* [Bootstrapping](#bootstrapping)
* [Usage](#usage)
* [Ansible Control System Requirements](https://docs.ansible.com/ansible/latest/intro_installation.html#control-machine-requirements)
* A Fedora system with the `ansible` and `git` packages installed.
* Sudo permissions to run this playbook locally
1. In order to run this playbook, Ansible needs to be installed from the package repos:
```bash
sudo dnf install ansible
```
2. On your local system with ansible and git installed, clone this git repo.
First, take a look at the [setup-workstation.yml](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:
```bash
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:
```bash
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:
```bash
ansible-playbook setup-workstation.yml -vvvv
````