2022-02-28 09:41:10 +01:00
# Sysconfig
2021-10-31 17:14:55 +01:00
2022-02-27 13:37:53 +01:00
This is an Ansible playbook to deploy my system configurations for desktop usage.
2022-01-14 19:46:59 +01:00
## 🧰 Usage
- Have a fresh installation of Alpine (after running `setup-alpine` and reboot)
2022-02-27 13:37:53 +01:00
- Install `ansible-core` and `git`
2022-10-01 16:15:29 +02:00
- Clone this repository
2022-04-17 13:52:06 +02:00
- Install needed external modules (e.g. `apk` , `pamd` , `mount` ):
2022-02-28 09:41:10 +01:00
```bash
2022-11-05 05:21:19 +01:00
ansible-galaxy install -r requirements/collections.yml
2022-02-28 09:41:10 +01:00
```
2022-01-14 19:46:59 +01:00
- Create an encrypted file to store your user password:
2022-01-26 16:14:22 +01:00
```bash
mkdir -p host_vars/YOUR_HOSTNAME
touch host_vars/YOUR_HOSTNAME/secrets.yml
ansible-vault encrypt host_vars/YOUR_HOSTNAME/secrets.yml
ansible-vault edit host_vars/YOUR_HOSTNAME/secrets.yml
2022-01-14 19:46:59 +01:00
```
The file should look like this: `vault_password: <strong_&_secure_password>`
2022-10-01 16:15:29 +02:00
- Customize the variables in [group_vars/all.yml ](./group_vars/all.yml ).
2023-04-05 19:00:00 +02:00
Note that some variables only accept a list of defined values. They are listed in [requirements/accepted_variables.yml ](./requirements/accepted_variables.yml ).
2022-10-01 16:15:29 +02:00
2022-01-14 19:46:59 +01:00
- Run the playbook:
2022-01-26 16:14:22 +01:00
```bash
2022-02-27 13:20:25 +01:00
ansible-playbook setup.yml
2022-01-14 19:46:59 +01:00
```
- Reboot and login as the newly created normal user
2024-01-26 18:00:00 +01:00
- Proceed with [dotfiles-ansible ](/folliehiyuki/dotfiles-ansible ) playbook
2022-01-14 19:46:59 +01:00
## 🖊️ Notes
2023-09-30 19:00:00 +02:00
- This playbook assumes that the person running it is me 😃 and targets a single-user AlpineLinux system. It might do specific tasks that you don't like. Use with your own risks.
2022-01-14 19:46:59 +01:00
2023-04-05 19:00:00 +02:00
- The playbook assumes it's only run once. As such it doesn't take into account conflicted services when switching options in later runs.
2022-10-29 19:35:50 +02:00
2024-01-26 18:00:00 +01:00
- The playbook is intended to be run as **root** . Hence, it is separated from [dotfiles-ansible ](/folliehiyuki/dotfiles-ansible ), which should only be run as a normal user.
2022-01-14 19:46:59 +01:00
## 📄 License
MIT