From 6d63780b428f44a5ae317fc4fc1dface2df20ab4 Mon Sep 17 00:00:00 2001 From: Ari Sosnovsky Date: Fri, 22 May 2026 18:15:38 -0400 Subject: [PATCH] readme --- README.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6526e5c..e1df479 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,25 @@ # (My) Homelab -Docs TBD +## Repository Structure + +- `bin/` – helper scripts +- `certs/` – TLS certificates +- `charts/` – Helm charts +- `os/` – OS‑specific configuration +- `tf-modules/` – reusable Terraform modules +- `tf-*.tf` – Terraform configuration files + +## Getting Started + +This repo uses Nix + Terraform to provision a homelab infrastructure. + +1. Bootstrap the environment: `nix develop` +2. Initialise Terraform: `terraform init` +3. Review the plan: `terraform plan` +4. Apply the configuration: `terraform apply` + +## Usage + +- Edit `var.auto.tfvars` for environment‑specific values. +- Run `./bin/` scripts to deploy services. +- Use `terraform state` commands to inspect resources.