added first node documentation

2026-05-06 20:30:10 +02:00 · 2026-05-05 09:24:56 +02:00
parent 6cd5710c79
commit 3bc79d8eaf
1 changed files with 108 additions and 0 deletions
@@ -0,0 +1,108 @@
+# Host: `geekprox`
+
+> Main Proxmox node, runs the *arr stack, downloading, transcding, media.
+
+---
+
+## Hardware
+
+| | |
+|---|---|
+| **Model** | Custom PC |
+| **CPU** | 6 x Intel(R) Core(TM) i5-9600K CPU @ 3.70GHz |
+| **RAM** | 64GB DDR4 |
+| **Storage** | 256GB NVMe (OS), 2x6TB HDD (media) |
+| **NIC** | Intel 4x gigabit |
+
+---
+
+## Identity
+
+| | |
+|---|---|
+| **Hostname** | `geekprox` |
+| **Static IP** | `10.0.50.50` |
+| **MAC Address** | `e4:1f:13:fc:73:5a` |
+| **OS / Version** | Proxmox VE 9.1.9 |
+
+---
+
+## Role & Purpose
+
+Describe what this machine does in 2–3 sentences. Include why it exists as a separate host (vs. running on another machine).
+
+---
+
+## Services Running
+
+| Service | Type | Port(s) | Notes |
+|---|---|---|---|
+| `service-name` | LXC / VM / Docker | `8080` | link to service doc |
+
+---
+
+## Key File Paths
+
+```
+/etc/hostname               # Hostname config
+/etc/network/interfaces     # Network config
+/var/lib/vz/                # Proxmox storage (if applicable)
+```
+
+Add any paths that are non-obvious or that you'll need in a recovery scenario.
+
+---
+
+## Proxmox / Virtualisation Notes
+
+*(Delete this section if bare-metal)*
+
+- **Proxmox node ID:** `N`
+- **Storage pools:** list pools and their purposes
+- **LXC templates used:** e.g. `debian-12-standard`
+- **VM/LXC IDs in use:** list them here to avoid collisions
+
+---
+
+## Provisioning
+
+How to go from a blank machine to a working host:
+
+1. Install OS (link to ISO / version)
+2. Run bootstrap playbook: `make bootstrap HOST=hostname`
+3. Run site playbook: `make deploy`
+4. Verify: list any smoke-test commands
+
+---
+
+## Backup
+
+| What | Where | How Often | Retention |
+|---|---|---|---|
+| Proxmox backup | PBS | Daily | 7 days |
+| Config files | Git | On change | Forever |
+
+---
+
+## Access
+
+```bash
+ssh user@192.168.x.x
+# or via Proxmox console: https://proxmox-main:8006
+```
+
+---
+
+## Known Issues / Gotchas
+
+- List anything surprising or non-obvious about this machine
+- Hardware quirks, BIOS settings, chipset limitations
+- Anything you had to Google that you don't want to Google again
+
+---
+
+## Change Log
+
+| Date | Change |
+|---|---|
+| YYYY-MM-DD | Initial setup |