Homelab ⚗️

This project aims to build a homelab for personal testing on infrastructure, development, CI/CD, etc...

It provides a complete configuration with common web services using ansible as a deployment tool for both infrastructure (gateway and k3s cluster) and applications running mainly in Kubernetes.

It is a quick starting point for simple infrastructure needs or for testing various tools such as monitoring, alerting, automated deployment, security testing, etc...

Documentation

Website: https://this-is-tobi.com/homelab/introduction.

Table of Contents - md sources:

• Compatibility
• Installation
• Infrastructure
• Services
• Projects
• Cheat sheet

Quickstart

Make sure all prerequisites are met.

Setup directory:

# Clone the repository
git clone --depth 1 https://github.com/this-is-tobi/homelab.git && cd ./homelab && rm -rf ./.git && git init

# Copy inventory example to inventory
cp -R ./ansible/infra/inventory-example ./ansible/infra/inventory
cp -R ./ansible/kube/inventory-example ./ansible/kube/inventory

Infra

Setup inventory:

• host.yml
• all.yml
• gateway.yml
• k3s.yml

Install:

# Install infra
./run.sh -p ./ansible/infra/install.yml -u -k

Kubernetes

Setup inventory:

• services.yml

Install:

# Set kube context
kubectl config set-context homelab

# Install services
./run.sh -p ./ansible/kube/install.yml -u