Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lucarickli/homelab

Last synced: 6 days ago
JSON representation

Host: GitHub
URL: https://github.com/lucarickli/homelab
Owner: LucaRickli
Created: 2024-01-31T15:01:00.000Z (10 months ago)
Default Branch: main
Last Pushed: 2024-08-19T13:00:01.000Z (3 months ago)
Last Synced: 2024-08-19T15:04:39.028Z (3 months ago)
Language: Dockerfile
Size: 31.3 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

        # Homelab

On-prem Kubernetes cluster.

## Requirements

### Command line tools

#### Required

- [Helm](https://helm.sh/docs/helm/helm_install/)

- [Kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)

- [Kubelogin](https://github.com/int128/kubelogin)

#### Optional

- [Cilium cli](https://docs.cilium.io/en/stable/gettingstarted/k8s-install-default/#install-the-cilium-cli)

- [CMctl](https://cert-manager.io/docs/reference/cmctl/#installation)

- [Talosctl](https://www.talos.dev/v1.6/introduction/getting-started/#talosctl)

## Hardware

- ### [Ubiquiti EdgeRouter X]()

  Acts as a sub-router in my network using static routes & proper firewall configuration.

- ### [Super6c raspberry pi cluster](https://deskpi.com/products/deskpi-super6c-raspberry-pi-cm4-cluster-mini-itx-board-6-rpi-cm4-supported)

  6 raspberry pi CM4 nodes with a single m.2 sdd each connected to an unmanaged switch all on a single board.

- ### [Raspberry pi 4 4GB]()

  Runs some docker services that cant run inside the cluster.

## Setup

### Kubernetes

> Keep in mind that this stuff cant run inside the kubernetes cluster and requires a separate docker host.

- #### [Sidero omni](https://github.com/LucaRickli/homelab/tree/main/omni)

  > Alternatively you could just use [Talos linux](https://github.com/LucaRickli/homelab/tree/main/talos) and [talosctl](https://www.talos.dev/v1.6/introduction/getting-started/#talosctl) to manage your nodes.

  Dashboard: [https://ceph.rickli.cloud](https://ceph.rickli.cloud)

  - Custom pre configured Talos linux images.

  - Cluster lifecycle management.

  - Kubernetes API access control (OAuth).

### Networking

- #### [Cilium](https://github.com/LucaRickli/homelab/tree/main/cilium)

  Dashboard: [https://hubble.rickli.cloud](https://hubble.rickli.cloud)

  - Replaces kube-proxy.

  - Acts as LoadBalancer & assigns external ip's.

  - Networking policies.

  - Service map (hubble).

- #### [External DNS](https://github.com/LucaRickli/homelab/tree/main/exDNS)

  Endpoint: [udp://172.16.1.1](#)

  - Resolves ingress hostnames to corresponding external virtual ip.

### Certificates

- #### [Cert manager](https://github.com/LucaRickli/homelab/tree/main/cert-manager)

  - Manages tls certificates for ingress resources thru private or public key infrastructure.

### Storage

- #### [Rook ceph](https://github.com/LucaRickli/homelab/tree/main/rook)

  Dashboard: [https://ceph.rickli.cloud](https://ceph.rickli.cloud)

  - Provides storage for the kubernetes cluster.

### Monitoring

- #### [Netdata](https://github.com/LucaRickli/homelab/tree/main/netdata)

  Dashboard: [https://netdata.rickli.cloud](https://netdata.rickli.cloud)

  - Monitors each node and provides a dashboard without a big configuration mess.

## IP ranges

### EdgeRouter

IP range: `192.168.10.0/24`

### kubernetes services

IP range: `172.16.0.0/16` (virtual)