A suite of Ansible collections designed for efficient infrastructure automation. These collections focus on immutable infrastructure patterns and are geared towards a homelab environments while being robust enough for production use.
- Immutable Infrastructure: Replace rather than patch - making your infrastructure more reliable
- Performance-Focused: Tasks run only when needed, optimized for speed without compromising security
- Declarative Configuration: Define desired states clearly and achieve them consistently
- Practical Solutions: Following best practices while staying pragmatic
| Collection | Capabilities | Status |
|---|---|---|
| 🔧 block_device | - Automated block device selection - Partition management - Filesystem creation - RAM disk setup |
 |
| ⚙️ configure | - Cloud-init configuration - Fstab configuration |
 |
| ☸️ k3s | - Automated k3s cluster node deployment - Multi-node cluster setup - Flux CD installation - Kubeconfig extraction |
 |
| 💻 os | - Prepare an OS with user specified set of packages - Upgrade all packages to latest - Optional kernel upgrade - Tune kernel settings ( sysctl)- Configure kernel module loading - Update initramfs |
 |
| 📦 packages | - Package installation/removal (with aptitude or from URL)- Prevent reinstallation for removed packages, if desired - Fast no-op shortcuit if requirements already met |
 |
| 🥧 raspberry_pi | - Kernel configuration (config.txt)- Kernel commandline parameter management ( cmdline.txt)- Pi-specific optimizations |
 |
- Block Device Management: Automated disk provisioning, partitioning, and filesystem setup
- Kubernetes Deployment: Streamlined k3s cluster setup with Flux CD integration
- System Configuration: Comprehensive OS and service configuration management
- Package Handling: Flexible package management across different architectures
- Raspberry Pi Support: Specialized tools for Pi-based infrastructure
Each collection is designed for specific infrastructure needs:
- Setting up storage? → block_device collection handles automated disk management
- Deploying Kubernetes? → k3s collection provides streamlined cluster setup
- Configuring systems? → configure collection manages system settings
- Managing packages? → packages collection handles software deployment
- Working with Raspberry Pi? → raspberry_pi collection offers Pi-specific tools
Visit each collection's documentation for detailed usage instructions and examples.
- Comprehensive Molecule tests for each collection
- Continuous Integration via GitHub Actions
- Automated linting and syntax checking
- Detailed documentation requirements
We welcome contributions! See our Contributing Guide for:
- Development setup
- Code style guidelines
- Testing requirements
- Pull request process
- 🐛 Found a bug? Open an issue
- 💡 Have an idea? Start a discussion
- 🤝 Want to contribute? Check our Contributing Guide
This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0) - see the LICENSE file for details.
Built for the homelab community