From d671a271b04d37cca6e3b3a2c8bfa991b74ab159 Mon Sep 17 00:00:00 2001
From: Ben Miller <ben.p.miller@gmail.com>
Date: Sat, 14 Jun 2025 03:08:55 -0600
Subject: [PATCH] initial homelab doc

---
 homelab.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 homelab.md

diff --git a/homelab.md b/homelab.md
new file mode 100644
index 0000000..fd4ed2e
--- /dev/null
+++ b/homelab.md
@@ -0,0 +1,68 @@
+# homelab
+
+## things to set up
+
+### Gitea
+
+### Caddy
+
+### Authentik
+
+## Network
+
+```mermaid
+graph TD;
+  internet((Internet))<-->nest_wifi_pro(Nest Wifi Pro);
+  nest_wifi_pro<-->microtik;
+  microtik<==>LACP(LACP/VLAN trunk);
+  LACP<-->vlan86;
+  LACP<-->vlan200;
+  vlan86<-->proxmox_eth0[eth0]<-->proxmox;
+  vlan86<-->proxmox_eth1[eth1]<-->proxmox;
+  vlan200<-->proxmox_eth0[eth0]<-->proxmox;
+  vlan200<-->proxmox_eth1[eth1]<-->proxmox;
+  proxmox<-->bond0<-->vmbr0<-->VMs;
+  vlan200<-->vault_eth3[eth3]<-->vault;
+  vlan200<-->vault_eth4[eth4]<-->vault;
+```
+
+### DNS
+
+```mermaid
+graph LR;
+  internet((Internet))<-->porkbun;
+  porkbun<-->hobbithole_org(hobbithole.org);
+  hobbithole_org<-->opnsense;
+  opnsense<-->caddy;
+  caddy<-->vault;
+  caddy<-->proxmox;
+  opnsense<-->hh_lan(hh.lan)<-->bind<-->unbound;
+  unbound<-->vault;
+  unbound<-->proxmox;
+  proxmox[proxmox + VMs];
+
+```
+
+* External domain: `hobbithole.org`
+  * Hosted on SquareSpace, about to move over to PorkBun
+* Internal domain: `hh.lan`
+  * Unbound transparent domain --> BIND authoritative domain
+    * Hosted on OPNsense
+    *
+
+### IPAM
+
+* wifi: `192.168.86.0/24`
+* services: `192.168.200.0/24`
+*
+
+## Proxmox
+
+### Hosts
+
+* `proxmox1.hh.lan`
+  * 192.168.200.101
+* `proxmox2.hh.lan`
+  * 192.168.200.102
+* `proxmox3.hh.lan`
+  * 192.168.200.103