mirror of
https://github.com/vrd1/homelab-2.0.git
synced 2026-05-06 20:30:10 +02:00
added first node documentation
This commit is contained in:
+108
@@ -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 |
|
||||||
Reference in New Issue
Block a user