From 9b681171446880e78e59b2ab02158f6386b4d23f Mon Sep 17 00:00:00 2001
From: jazzymc <jazzymc@xtrm-lab.org>
Date: Mon, 19 Jan 2026 00:20:44 +0200
Subject: [PATCH] Add NetBox IPAM/DCIM to infrastructure documentation

- Added NetBox and related containers to 00-CURRENT-STATE.md
- Added netbox.xtrm-lab.org to services list
- Updated FolderView2 categories (Monitoring + DevOps)
- Added deployment changelog entry for 2026-01-19

Services deployed:
- netbox (port 8090)
- netbox-worker
- netbox-housekeeping
- netbox-postgres
- netbox-redis
- netbox-redis-cache

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/00-CURRENT-STATE.md | 10 ++++++++--
 docs/07-CHANGELOG.md     | 28 ++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/docs/00-CURRENT-STATE.md b/docs/00-CURRENT-STATE.md
index a1cadc2..67a2dfb 100644
--- a/docs/00-CURRENT-STATE.md
+++ b/docs/00-CURRENT-STATE.md
@@ -96,6 +96,12 @@
 | NetAlertX | NetAlertX | 20211 | host | netalert.xtrm-lab.org |
 | UrBackup | UrBackup | 55414 | host | urbackup.xtrm-lab.org |
 | Homarr | homarr | 10004→7575 | bridge | - |
+| NetBox | netbox | 8090→8080 | dockerproxy | netbox.xtrm-lab.org |
+| NetBox Worker | netbox-worker | - | netbox | - |
+| NetBox Housekeeping | netbox-housekeeping | - | netbox | - |
+| NetBox PostgreSQL | netbox-postgres | 5432 | netbox | - |
+| NetBox Redis | netbox-redis | 6379 | netbox | - |
+| NetBox Redis Cache | netbox-redis-cache | 6379 | netbox | - |
 | Nebula Sync | nebula-sync | - | - | Pi-hole sync |
 | DoH Server | DoH-Server | 8053 | dockerproxy | doh.xtrm-lab.org |
 | stunnel DoT | stunnel-dot | 853 | bridge | dns.xtrm-lab.org:853 |
@@ -324,8 +330,8 @@ Docker containers are organized into categories using the FolderView2 plugin.
 |----------|------------|------|
 | Infrastructure | traefik, unbound, binhex-official-pihole, DoH-Server, stunnel-dot, pangolin, dockersocket, nebula-sync | network.svg |
 | Security | authentik, authentik-worker, vaultwarden | shield-lock.svg |
-| Monitoring | UptimeKuma, Uptime-Kuma-API, AutoKuma, NetAlertX, speedtest-tracker | monitoring.svg |
-| DevOps | gitea, woodpecker-server, woodpecker-agent, postgresql17, Redis, pgAdmin4 | database-03.svg |
+| Monitoring | UptimeKuma, Uptime-Kuma-API, AutoKuma, NetAlertX, speedtest-tracker, netbox, netbox-worker, netbox-housekeeping | monitoring.svg |
+| DevOps | gitea, woodpecker-server, woodpecker-agent, postgresql17, Redis, pgAdmin4, netbox-postgres, netbox-redis, netbox-redis-cache | database-03.svg |
 | Media | plex, Libation, transmission | media-play-circle.svg |
 | Storage/Backup | rustfs, UrBackup, TimeMachine, Nextcloud | clock-rewind.svg |
 | Productivity | actual-budget, n8n, karakeep, homarr | dashboard.svg |
diff --git a/docs/07-CHANGELOG.md b/docs/07-CHANGELOG.md
index 932de01..cdfb68b 100644
--- a/docs/07-CHANGELOG.md
+++ b/docs/07-CHANGELOG.md
@@ -1,5 +1,33 @@
 # Infrastructure Changelog
 
+## 2026-01-19 - NetBox IPAM/DCIM Deployment
+
+### NetBox Installation
+- [SERVICE] netbox: Deployed NetBox IPAM/DCIM on port 8090
+- [SERVICE] netbox-worker: Background task worker
+- [SERVICE] netbox-housekeeping: Database maintenance
+- [SERVICE] netbox-postgres: Dedicated PostgreSQL 16 database
+- [SERVICE] netbox-redis: Persistent Redis for queues
+- [SERVICE] netbox-redis-cache: Redis cache instance
+
+### Configuration
+- URL: https://netbox.xtrm-lab.org
+- Local: http://192.168.31.2:8090
+- Network: dockerproxy (for Traefik) + netbox (internal)
+- Data: /mnt/user/appdata/netbox/
+
+### DNS
+- [DNS] Added netbox.xtrm-lab.org to Cloudflare
+
+### Purpose
+- IP Address Management (IPAM)
+- Data Center Infrastructure Management (DCIM)
+- VLAN documentation and planning
+- Network device inventory
+- Cable/connection tracking
+
+---
+
 ## 2026-01-18 - MikroTik WiFi & CAPsMAN Configuration
 
 ### CAPsMAN Setup