Quick Reference Guide¶

Last Updated: 2026-03-06

Quick access to frequently needed information. Keep this file updated as things change.

Network Information¶

LAN Configuration¶

Router: UDM Pro
Default Subnet: 192.168.4.0/24
Gateway: 192.168.4.1
DNS Primary: NextDNS
DNS Secondary: Router fallback (192.168.4.1)
Full network docs: network.md

VLANs¶

Network	Subnet	Purpose
Default	192.168.4.0/24	Main LAN
Servers	192.168.9.0/24	Server VLAN
DMZ	192.168.90.0/24	DMZ
Guest	192.168.123.0/24	Guest WiFi
W4TRC	192.168.146.0/24	Amateur radio (EchoLink)
Backup Internet	192.168.250.0/24	WAN failover
Sandbox	192.168.99.0/27	Testing
TEST	10.10.90.0/24	Testing

IP Addresses¶

Device/Service	IP Address	Notes
Router/Gateway	192.168.4.1	UDM Pro, Gateway, DHCP
Caddy (Reverse Proxy)	192.168.4.2	Reverse proxy, ports 80/443
JC-PVE01	192.168.4.21	Proxmox node
JC-PVE02	192.168.4.22	Proxmox node
JC-PVE03	192.168.4.23	Proxmox node
JC-PVE04	192.168.4.24	Proxmox node
MQTT Broker	192.168.4.66	Ports 1883, 9001
Synology NAS (Vault)	192.168.4.5	NAS / Backblaze B2 offsite
Minecraft Server	192.168.9.133	Servers VLAN
EchoLink Node	192.168.146.21	W4TRC VLAN

Access Methods¶

Web Interfaces¶

Infrastructure Management¶

Service	URL	Location	Access Method
Proxmox JC-PVE01	https://192.168.4.21:8006	JC-PVE01	LAN / VPN
Proxmox JC-PVE02	https://192.168.4.22:8006	JC-PVE02	LAN / VPN
Proxmox JC-PVE03	https://192.168.4.23:8006	JC-PVE03	LAN / VPN
Proxmox JC-PVE04	https://192.168.4.24:8006	JC-PVE04	LAN / VPN
Synology DSM	https://192.168.4.5:5000	Vault (NAS)	LAN / VPN

Monitoring & Network Services¶

Service	URL	Location	Access Method
Uptime Kuma			LAN / VPN
Grafana			LAN / VPN
Prometheus			LAN / VPN
Zabbix			LAN / VPN

Core Applications¶

Service	URL	Location	Access Method
Home Assistant			LAN / VPN
Jellyfin			LAN / VPN

Utility Services¶

Service	URL	Location	Access Method
Caddy (admin)			LAN / VPN

Remote Access¶

Tailscale: - All nodes enrolled in Tailscale for remote access - Admin access via Tailscale only (no public port forwarding) - See Tailscale docs for details

Reverse Proxy: - Caddy used as reverse proxy - See Caddy docs for virtual host configuration

Security Rules: - Port forwarding enabled for: Reverse Proxy (80/443), MQTT (1883/9001), Minecraft, EchoLink - No public SSH access - Admin access only via VPN (Tailscale) - See network.md for full port forwarding table

Hardware Quick Reference¶

Full specs: Hardware Inventory (single source of truth)

JC-PVE01 (192.168.4.21)¶

OS: Proxmox
Power: Always-on

JC-PVE02 (192.168.4.22)¶

OS: Proxmox
Power: Always-on

JC-PVE03 (192.168.4.23)¶

OS: Proxmox
Power: Always-on

JC-PVE04 (192.168.4.24)¶

OS: Proxmox
Power: Always-on

Synology NAS¶

OS: Synology DSM
Power: Always-on

Critical Services¶

Service	Current Location	Priority	Daily Use?
Home Assistant		High	Yes
Jellyfin		Medium	Yes
Uptime Kuma		Medium	No (monitoring)
Grafana		Medium	No (monitoring)
Prometheus		Medium	No (monitoring)
Zabbix		Medium	No (monitoring)
Caddy		High	Yes (proxy)
Tailscale	All nodes	High	Yes (remote access)

Backup Locations¶

VM Backups¶

Method: Proxmox Backup Server (PBS) — LXC on JC-PVE04
Storage: Synology NAS (Vault, 192.168.4.5)
Schedule: Nightly at 2:00 AM
Retention:
Restore tested: Partial (some VMs tested, no full restore drill)

Application Data¶

Offsite: Backblaze B2 via Synology NAS

Common Commands¶

Proxmox (via SSH or Shell)¶

# List all VMs
qm list

# Start a VM
qm start <VMID>

# Stop a VM
qm stop <VMID>

# Cluster status
pvecm status

# Storage status
pvesm status

Synology NAS (via SSH)¶

# Check volume health
cat /proc/mdstat

# List shares
ls /volume1/

# Check disk health
smartctl -H /dev/sda

Docker¶

# List running containers
docker ps

# Check logs
docker logs <container_name>

# Restart a container
docker restart <container_name>

Storage & Disk Health¶

# Check S.M.A.R.T. status
smartctl -A /dev/sda              # Full S.M.A.R.T. attributes
smartctl -H /dev/sda              # Quick health check (PASSED/FAILED)

# Disk usage
df -h                             # Filesystem usage
du -sh /path/*                    # Directory sizes
lsblk                             # Block device tree

Networking¶

# Interface and IP info
ip a                              # All interfaces and IPs
ip r                              # Routing table

# Active connections and listening ports
ss -tulpn                         # TCP/UDP listeners with process names

# Connectivity tests
ping -c 4 192.168.4.1             # Test gateway
ping -c 4 1.1.1.1                 # Test internet
nslookup google.com               # Test DNS resolution

Services & Logs¶

# Systemd service management
systemctl status <service>        # Service status
systemctl restart <service>       # Restart service
systemctl enable <service>        # Enable on boot

# Log viewing
journalctl -u <service> -f        # Follow service logs
journalctl -u <service> --since "1 hour ago"
dmesg -T | tail -50               # Recent kernel messages (with timestamps)

# Docker logs (with options)
docker logs -f <container>        # Follow logs
docker logs --tail 100 <container> # Last 100 lines

Proxmox Specific¶

# Cluster and node info
pvesh get /nodes                  # List nodes
pvecm status                      # Cluster status

# Task and backup info
pveam list local                  # Available templates
pvesm status                      # Storage status

# VM disk info
qm config <VMID>                  # VM configuration

fail2ban¶

# Status
fail2ban-client status            # List active jails
fail2ban-client status sshd       # SSH jail status + banned IPs

# Manage bans
fail2ban-client unban <IP>        # Unban specific IP
fail2ban-client unban --all       # Unban all IPs

# After config changes
fail2ban-client reload            # Reload configuration
systemctl restart fail2ban        # Full restart

Emergency Resources¶

When Things Break¶

Priority Order: 1. Check this documentation first 2. Check service logs 3. Check Uptime Kuma / Grafana for status 4. Restart the service 5. Check backup availability 6. Ask for help (forums, Claude, etc.)

Useful Resources¶

Proxmox Docs: https://pve.proxmox.com/wiki/Main_Page
Synology Docs: https://kb.synology.com/
Home Assistant Docs: https://www.home-assistant.io/docs/
Your Homelab Docs: (This repository!)

Support Communities¶

r/homelab
r/selfhosted
Proxmox Forums
Synology Forums
Home Assistant Community

Quick Decision Tree¶

"Should I restart the server?"¶

Any Proxmox Node: - Check: Are VMs / containers running on it? - Check: Is any critical service (HA, Jellyfin, Caddy) hosted there? - Check: Is monitoring flagging it? - If all clear: OK to restart

Synology NAS: - Check: Are backups currently running? - Check: Is Backblaze B2 sync in progress? - If all clear: OK to restart

Passwords & Secrets¶

DO NOT store passwords in this file!

Use a password manager (Bitwarden, 1Password, KeePass, etc.)

Store: - Server admin passwords - Service admin passwords - API keys - VPN auth keys - Backblaze B2 credentials

Remember: Update this file whenever you change IPs, add services, or complete migrations!

Last Verified: 2026-03-06