Skip to content

🏡 Homelab Playbooks 🚀

task ci

Ansible playbooks repo for my homelab.

📌 TL;DR

  • Install dependencies: task deps
  • Generate a new vault password: task init
  • Edit secrets: task ve
    • Edit role variables: ansible-vault edit roles/<role>/vars/main.yaml
  • Update all hosts: ansible-playbook playbooks/update_all.yaml
  • See all available tasks: task -l

🖼 Background

This repository contains Ansible playbooks used to configure and manage my homelab environment. The playbooks are designed to be idempotent and are used to set up and maintain various services and configurations across different types of machines, including Ubuntu servers, Raspberry Pis, Proxmox VE nodes, LXC containers, and Docker hosts.

👷 Prerequisites

Note

Please ensure that python3 is installed on the hosts you want to manage. For more details, see the Getting Started guide.

📦 Installation

To get started, clone the repository and install the dependencies:

git clone https://github.com/nicholaswilde/homelab-playbooks.git
cd homelab-playbooks
task deps

For more detailed instructions, see the Getting Started guide.

🛠 Development

This project uses Task for command running and MkDocs for documentation.

For more information on development, see the Development guide.

⚖ License

​​Apache License 2.0

📝​Author

​This project was started in 2025 by ​Nicholas Wilde​.

🔗 References