infrastructure/docs/13-CONTAINER-IP-ASSIGNMENTS.md

Container Static IP Assignments

Last Updated: 2026-01-20

This document lists all static IP assignments for Docker containers on Unraid.

---

dockerproxy Network (172.18.0.0/16)

Static IP range: 172.18.0.2 - 172.18.0.99

Core Infrastructure (172.18.0.2 - 172.18.0.10)

Container	Static IP	Purpose
dockersocket	172.18.0.2	Docker socket proxy
traefik	172.18.0.3	Reverse proxy
homarr	172.18.0.4	Dashboard

Security (172.18.0.11 - 172.18.0.15)

Container	Static IP	Purpose
authentik	172.18.0.11	Identity provider
authentik-worker	172.18.0.12	Authentik worker
postgresql17	172.18.0.13	PostgreSQL database
Redis	172.18.0.14	Redis cache
vaultwarden	172.18.0.15	Password manager

Productivity (172.18.0.16 - 172.18.0.30)

Container	Static IP	Purpose
actual-budget	172.18.0.16	Budget tracking
n8n	172.18.0.17	Workflow automation
Uptime-Kuma-API	172.18.0.18	Uptime API
AutoKuma	172.18.0.19	Auto Kuma config
UptimeKuma	172.18.0.20	Uptime monitoring
speedtest-tracker	172.18.0.21	Speed test tracking
DoH-Server	172.18.0.22	DNS over HTTPS
Libation	172.18.0.23	Audiobook manager
Nextcloud	172.18.0.24	Cloud storage
karakeep	172.18.0.25	Bookmark manager
transmission	172.18.0.26	Torrent client

DevOps (172.18.0.31 - 172.18.0.40)

Container	Static IP	Purpose
gitea	172.18.0.31	Git server
woodpecker-server	172.18.0.32	CI/CD server
woodpecker-agent	172.18.0.33	CI/CD agent

NetDisco (172.18.0.41 - 172.18.0.50)

Container	Static IP	Purpose
netdisco-web	172.18.0.41	NetDisco web UI
netdisco-backend	172.18.0.42	NetDisco SNMP poller

Fossorial/Pangolin (172.18.0.51 - 172.18.0.60)

Container	Static IP	Purpose
pangolin	172.18.0.51	Pangolin tunnel

---

netbox Network (172.24.0.0/16)

Static IP range: 172.24.0.2 - 172.24.0.20

Container	Static IP	Purpose
netbox-redis	172.24.0.2	NetBox Redis
netbox-redis-cache	172.24.0.3	NetBox Redis cache
netbox-postgres	172.24.0.4	NetBox PostgreSQL
netbox	172.24.0.5	NetBox web UI
netbox-worker	172.24.0.6	NetBox worker
netbox-housekeeping	172.24.0.7	NetBox housekeeping

---

br0 Network (LAN Macvlan - 192.168.31.x)

These containers have direct LAN access via macvlan.

Container	Static IP	Purpose
binhex-official-pihole	192.168.31.4	DNS sinkhole
unbound	192.168.31.5	Recursive DNS
TimeMachine	192.168.31.12	Time Machine backup

---

bridge Network (172.17.0.0/16)

Default Docker bridge - dynamic IPs (no static assignment supported).

Container	Purpose
portainer	Container management
rustdesk-hbbs	RustDesk signaling
rustdesk-hbbr	RustDesk relay
rustfs	Rust filesystem

---

Host Network

These containers share the host network stack.

Container	Purpose
unimus	Network config backup
UrBackup	Backup server
NetAlertX	Network scanner
plex	Media server
HomeAssistant_inabox	Home automation
stunnel-dot	DNS over TLS
nebula-sync	Nebula mesh sync

---

IP Assignment Command

To assign a static IP to a container:

# Disconnect from network
docker network disconnect <network> <container>

# Reconnect with static IP
docker network connect --ip <ip> <network> <container>

Note: Static IPs only work on user-defined networks (not the default bridge).

---

Maintenance

When recreating containers, ensure static IPs are preserved by:

1. Using --ip flag in docker run
2. Or running the disconnect/connect commands after container creation