chore: first commit

2025-07-25 20:23:54 +02:00
parent 5c4016357f
commit c612cc7839
88 changed files with 3255 additions and 0 deletions
@@ -0,0 +1,40 @@
+# Homelab Ansible Playbooks
+
+This repository contains Ansible playbooks and roles I use to manage my NAS and several VMs 👨‍💻.
+
+This project is designed for personal/familial scale maintenance, if you find this useful for your use, want to share advises or security concerns, feel free to drop me a line.
+
+This is a good playground to learn and I encourage you to adapt these roles to your needs. While they might not be production-ready for all environments, I'm open to adapting them for [Ansible Galaxy]((https://galaxy.ansible.com)) if there's community interest!
+
+## Requirements
+
+```sh
+ansible-galaxy collection install -r requirements.yml
+```
+
+## Usage
+
+```sh
+ansible-playbook -i inventory.yml playbook.yml
+```
+
+## Target devices configuration
+
+Requirements:
+
+- sshd up and running
+- public key copied:
+
+```sh
+ssh-copy-id -i ~/.ssh/id_rsa.pub username@remote_host
+```
+
+- python3 installed (`pacman -Syu python3`)
+
+## Developping
+
+Linting:
+
+```sh
+npx prettier --write .
+```