mirrors/khuedoan-homelab
1
0
Fork 0
mirror of https://github.com/khuedoan/homelab.git synced 2024-12-22 15:24:31 +07:00
Code Issues Packages Projects Releases Wiki Activity
Modern self-hosting framework, fully automated from empty disk to operating services with a single command.
1,038 Commits 6 Branches 8 Tags 12 MiB
Python 41.2%
Go 22.9%
HCL 12%
Jinja 9.8%
Shell 4.5%
Other 9.6%
da0b8f0450
Go to file
Khue Doan da0b8f0450 style: do not detect YAML files 
Too many of them
2021-12-25 19:54:26 +07:00
.tekton refactor(external): create terraform secrets after apply 2021-12-25 10:58:54 +07:00
apps Revert "refactor(blog): use internal registry endpoint" 2021-12-25 14:46:00 +07:00
bootstrap refactor: expose ArgoCD to the internet 2021-12-24 16:50:27 +07:00
docs docs: update roadmap and feature list 2021-12-25 15:23:03 +07:00
external refactor(external): create terraform secrets after apply 2021-12-25 10:58:54 +07:00
metal feat(metal): generate SSH key automatically if not exists 2021-12-25 14:56:49 +07:00
platform fix(authentik): re-enable Redis 2021-12-25 18:50:56 +07:00
scripts feat(scripts): add script to show homelab status 2021-12-05 08:56:18 +07:00
system Revert "refactor(cloudflared): point to HTTP port of NGINX instead of HTTPS" 2021-12-25 17:59:53 +07:00
tools add new line, alphabet sorted 2021-12-05 21:57:33 +07:00
.gitattributes style: do not detect YAML files 2021-12-25 19:54:26 +07:00
.gitignore refactor: remove Terraform and CoreOS files from ignore list 2021-12-05 11:42:24 +07:00
LICENSE.md style: convert LICENSE to Markdown 2021-11-18 00:35:38 +07:00
Makefile build: add target to build all including external 2021-12-11 18:56:55 +07:00
README.md docs: update roadmap and feature list 2021-12-25 15:23:03 +07:00

README.md

Homelab

This is my homelab set up, it focused on automation to simplify provisioning, upgrading, and operating self-hosted services.

! ⚠️ WORK IN PROGRESS

Overview

Hardware

Hardware

  • 4 nodes of NEC SFF PC-MK26ECZDR (Japanese version of the ThinkCentre M700):
    • CPU: Intel Core i5-6600T @ 2.70GHz
    • RAM: 16GB
    • SSD: 128GB
  • TP-Link TL-SG108 switch:
    • Ports: 8
    • Speed: 1000Mbps

Features

Status: Alpha

  • Common applications: Gitea, Seafile, Jellyfin, Paperless...
  • Automated bare metal provisioning with PXE boot
  • Automated Kubernetes installation and management
  • Installing and managing applications using GitOps
  • Modular architecture, easy to add or remove features/components
  • Automated certificate management
  • Automatically update DNS records for exposed services
  • Expose services to the internet securely with Cloudflare Tunnel
  • CI/CD platform
  • Private container registry
  • Distributed storage
  • Monitoring and alerting 🚧
  • Support multiple environments (dev, stag, prod) 🚧
  • Automated offsite backups 🚧
  • Single sign-on 🚧

See Roadmap for more details.

Tech stack

Logo Name Description
Ansible Ansible Automate bare metal provisioning and configuration
ArgoCD ArgoCD GitOps tool built to deploy applications to Kubernetes
Cloudflare Cloudflare DNS and Tunnel
Docker Docker Ephermeral PXE server and convenient tools container
Gitea Gitea Self-hosted Git service
Grafana Grafana Operational dashboards
Helm Helm The package manager for Kubernetes
K3s K3s Lightweight distribution of Kubernetes
Kubernetes Kubernetes Container-orchestration system, the backbone of this project
Let's Encrypt Let's Encrypt Free, automated (via cert-manager), and open certificate authority
Loki Loki Log aggregation system
Longhorn Longhorn Cloud native distributed block storage for Kubernetes
MetalLB MetalLB Bare metal load-balancer for Kubernetes
NGINX NGINX Kubernetes Ingress Controller
Prometheus Prometheus Systems monitoring and alerting toolkit
Rocky Linux Rocky Linux Base OS for Kubernetes nodes
Tekton Tekton Cloud native solution for building CI/CD systems
Trow Trow Private container registry
Vault Vault Secrets and encryption management system

Get Started

Roadmap

See roadmap and open issues for a list of proposed features and known issues.

Contributing

Any contributions you make, either big or small, are greatly appreciated.

License

Distributed under the GPLv3 License. See LICENSE for more information.

Acknowledgements

Stargazers over time

Stargazers over time