Bluemedia/desktop-config
1
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

Add README.md

Browse source
This commit is contained in:
Oliver Traber 2024-10-12 19:18:39 +02:00
parent b1a7bc6c42
commit 7b028ca885
Signed by: Bluemedia
GPG key ID: C0674B105057136C
1 changed files with 32 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
README.md Normal file
View file

@ -0,0 +1,32 @@
# My personal Linux desktop setup
This repo contains a ansible playbook to bootstrap workstations with my custom Hyprland based desktop environment and commonly used apps.
It's like a dotfile repo, but with extended functionality.
## Customization
The playbook renders the config based on the configured host variables for the machine that it's running on.
To add a new host, add it's hostname to the inventory and create a corresponding host_vars file. You can take a look at the already existing configuation as an example.
## Usage
This playbook is intended to run on Debian testing/sid with only the "default tools" options selected at the time of install.
Run the folowing commands to get a ready to use system:
```bash
git clone https://git.bluemedia.dev/Bluemedia/desktop-config.git
cd desktop-config
bash prerequisites.sh
# Uncomment apps you want to install
nano main.yml
ansible-playbook --ask-become-pass -i inventory/ main.yml
# Reboot after the playbook finished
sudo reboot
```
To update a installed system:
```bash
cd desktop-config
git pull
ansible-playbook --ask-become-pass -i inventory/ main.yml
# Reboot after the playbook finished
sudo reboot
```