https://github.com/ol3d/home-ops

Automated Homelab setup and configuration, following GitOps and Infrastructure as Code (IaC) best practices where possible. Built on Proxmox using Terraform and Ansible.
https://github.com/ol3d/home-ops

ansible automation ceph devops docker gitops infrastructure-as-code kubernetes packer renovate selfhosted terraform

Last synced: 25 days ago
JSON representation

Automated Homelab setup and configuration, following GitOps and Infrastructure as Code (IaC) best practices where possible. Built on Proxmox using Terraform and Ansible.

• Host: GitHub
• URL: https://github.com/ol3d/home-ops
• Owner: ol3d
• License: mit
• Created: 2022-08-15T21:17:27.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-11-27T21:33:25.000Z (26 days ago)
• Last Synced: 2024-11-27T22:27:51.657Z (26 days ago)
• Topics: ansible, automation, ceph, devops, docker, gitops, infrastructure-as-code, kubernetes, packer, renovate, selfhosted, terraform
• Language: HCL
• Homepage:
• Size: 12.7 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Home-Ops

The main goals of this repository are to be a source of truth for my homelab, and to automate as much of it as possible. This project utilizes [Infrastructure as Code](https://en.wikipedia.org/wiki/Infrastructure_as_code) and [GitOps](https://codefresh.io/learn/gitops/) to simplify provisioning, operating, and updating self-hosted and cloud services in my homelab. The effort put into the various automation flows can make the ease of setup and teardown worth it.

A large goal for my homelab is to be as fully automated as possible while allowing user intervention and control when necessary. However, the process of automation can be complex, and the effort to set up a well thought out automation flow may take more time than its worth in the end.

> **What is a homelab?**

>

> A homelab is a space where individuals can create their own customized computing environments for experimentation, learning, and practical applications.

>

> Homelabs provide enthusiasts, hobbyists, and professionals with a sandbox-like environment to explore new technologies, develop skills, and test solutions without the constraints and limitations of traditional production environments.

---

## Overview

This is a mono respository for my home infrastructure and other self hosted services. The repository is constantly changing and adapting to new technologies being released and updated. Currently, tools such as [Ansible](https://www.ansible.com/), [Terraform](https://www.terraform.io/), and [GitHub Actions](https://github.com/features/actions) are being used to improve the workflow and adhere to IaC and GitOps practices. A list of all additional tools and services being used within this project can be found [here](reference/homelab/services/).

All of the homelab references down below can be found within the [**Reference**](reference/) navigation tab.

---

## Initial Setup

Although this repository is very personalized to my own homelab, it can be used as a generalized template for setting up your own homelab. To begin the initial setup, follow the guides/steps within the [**Setup**](setup/) portion of this documentation. Each section is critical to be able to progress into more advanced topics.