https://github.com/nadmax/homelab

Homelab in DevOps ways
https://github.com/nadmax/homelab

ansible automation cluster devops homelab kubernetes opentofu terraform

Last synced: 7 months ago
JSON representation

Homelab in DevOps ways

• Host: GitHub
• URL: https://github.com/nadmax/homelab
• Owner: nadmax
• License: apache-2.0
• Created: 2025-04-16T09:01:48.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-07-07T13:45:34.000Z (7 months ago)
• Last Synced: 2025-07-07T14:54:34.806Z (7 months ago)
• Topics: ansible, automation, cluster, devops, homelab, kubernetes, opentofu, terraform
• Language: Just
• Homepage:
• Size: 294 KB
• Stars: 22
• Watchers: 2
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
# Homelab

The aim of this project is to create a local Kubernetes cluster that can be replicated on your premises.  

It is built with automation and scalability in mind.  

Perfect for learning, testing, and tinkering.  

## Overview

The architecture consists of **three Incus instances** orchestrated into a Kubernetes cluster.  

Each VM is provisioned, configured, and container-ready with Docker and Kubernetes.

**Tech Stack:**

- [OpenTofu](https://opentofu.org/): Infrastructure as Code (IaC) to define and deploy instances  

- [Cloud-init](https://cloudinit.readthedocs.io/en/latest/index.html): Associated with OpenTofu to define users and metadatas

- [Incus](https://registry.terraform.io/providers/lxc/incus/latest/docs): Incus provider to manage instances

- [Ansible](https://docs.ansible.com/ansible/latest/index.html): Automates k8s cluster setup and configuration tasks  

- [Docker](https://www.docker.com/): Container runtime for workloads  

- [Kubernetes](https://kubernetes.io/): Container orchestration for deploying and managing applications  

- [Just](https://just.systems/): Command runner to simplify project automation and scripting  

## Documentation

The documentation is available [here](https://github.com/nadmax/homelab/blob/master/docs/README.md).  

**Please read it carefully!**

## Contributing

All contributions are welcome and appreciated.  

Please make sur to read the [contributing guide](https://github.com/nadmax/homelab/blob/master/CONTRIBUTING.md) for guidelines before submitting a pull request.