From d365f2ba7d789b2e155c0f038f89ac5abe9e4d45 Mon Sep 17 00:00:00 2001 From: Kumar Damani Date: Wed, 2 Aug 2023 17:29:24 -0400 Subject: Added readme --- README.md | 40 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..8aa2522 --- /dev/null +++ b/README.md @@ -0,0 +1,40 @@ +# My Home-Lab as Code + +Welcome to my home!...lab. + +This is my personal project to setup all my `r/self-hosted` services +in my home-lab. + +The goal of this repo is to be able to survive a dooms-day scenario where all +of my hosts die, and I can use to use this repo to be able to re-create it all +automatically. + +I use Proxox VE 8, which comes with a very recent kernel and thus good HW support +for my hypervisor host - a Framework Laptop. Yes, you read that right. +Before you start calling me a sadist, the main reason (other than money) I went with +this is that frankly, I have no better use for this machine. It just sat around +powered down 99% of the time, and only got used for IaC stuff like this, or +personal blog posts. This machine is clearly overkill for these tasks. + +If we are to get technical - this is a git repo after all - +it (the mainboard) is running in its own case, in "standalone" mode aka. as a poor man's "server". +You can read more about this in my [blog](). + +Believe it or not, this is actually a big upgrade for me. Prior to this, all of my +services were running off my NAS - Rockchip RK3399, not an i7-1165G7. +And I quickly became aware of its limitation when trying to run Collabora Online one day... + +Anyways, now I can finally off-load most of "compute" work to better suited HW, and let the +NAS do its NAS thing - provide block storage via NFS to this "compute" server. + +# What is NOT covered in this repo? +* The NAS. I already covered this [here](https://gitlab.com/kdam0/vps#nas-setup). +* The Proxmox install itself, along with networking config of my lab. VPN, VLANs etc. +I go over this in my [blog](https://kumardamani.net/post/framework-server/). +For now, its all manual. + +# What IS covered in this repo? +* Creating the container/VM infrastructure with [Terraform](https://www.terraform.io/). +Refer to [this](./terraform/README.md). +* Setting up the application services I self-host with [Ansible](https://www.ansible.com/). +Refer to [this](./ansible/README.md). -- cgit v1.2.3