https://github.com/nadmax/infra

Declarative on-premise infrastructure powered by OpenTofu and K3s
https://github.com/nadmax/infra

automation cluster devops homelab k3s k3s-cluster kubernetes opentofu terraform

Last synced: 4 months ago
JSON representation

Declarative on-premise infrastructure powered by OpenTofu and K3s

• Host: GitHub
• URL: https://github.com/nadmax/infra
• Owner: nadmax
• License: mit
• Created: 2025-04-16T09:01:48.000Z (10 months ago)
• Default Branch: master
• Last Pushed: 2025-08-29T12:59:32.000Z (5 months ago)
• Last Synced: 2025-09-11T13:20:27.908Z (5 months ago)
• Topics: automation, cluster, devops, homelab, k3s, k3s-cluster, kubernetes, opentofu, terraform
• Language: Go
• Homepage:
• Size: 310 KB
• Stars: 29
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

          
![GitLab CI](https://gitlab.com/nadmax/infra/badges/master/pipeline.svg)  ![GitHub CI](https://github.com/nadmax/infra/actions/workflows/ci.yml/badge.svg)

# 👨‍💻Infra

Let's replicate on your premises a local k3s cluster!  

Built with automation and scalability in mind.  

Perfect for learning, testing, or going further.  

## Overview

To keep it simple, only one container is deployed by default.  

You are free to deploy as many containers as you wish, as long as you have the resources to run them.

**Tech Stack:**

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

- [k3s](https://k3s.io/): A Kubernetes distribution designed for production workloads

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

- [Terratest](https://terratest.gruntwork.io/): A Go library for testing infrastructure

- [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.