ansible-playbooks/README.md
2025-07-25 20:23:54 +02:00

41 lines
987 B
Markdown

# 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 .
```