Files
proxmox/docs/04-configuration/UDM_PRO_DHCP_RESERVATIONS_GUIDE.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands
- CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround
- CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check
- NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere
- MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates
- LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 15:46:57 -08:00

5.3 KiB

UDM Pro DHCP Static IP Reservations Configuration Guide

Last Updated: 2025-01-20
VLAN: 11 (MGMT-LAN)
Status: Manual Configuration Required


Overview

This guide provides step-by-step instructions for configuring static IP reservations (DHCP reservations) for the Management VLAN (VLAN 11) on the UDM Pro.


Required Static IP Reservations

The following static IP reservations need to be configured for VLAN 11 (MGMT-LAN):

IP Address Device/Hostname MAC Address Notes
192.168.11.1 UDM Pro (Gateway) UDM Pro MAC Gateway address
192.168.11.10 ML110 (Proxmox) [ML110 MAC] Proxmox host
192.168.11.11 R630-01 [R630-01 MAC] R630 node 1
192.168.11.12 R630-02 [R630-02 MAC] R630 node 2
192.168.11.13 R630-03 [R630-03 MAC] R630 node 3
192.168.11.14 R630-04 [R630-04 MAC] R630 node 4

Note: MAC addresses need to be obtained from the devices or UniFi Controller.


Configuration Steps

  1. Access UniFi Network Web Interface:

    • Open browser: https://192.168.0.1
    • Log in with admin credentials
  2. Navigate to Network Settings:

    • Go to SettingsNetworks
    • Click on MGMT-LAN network (VLAN 11)
  3. Configure DHCP Reservations:

    • Scroll to DHCP Settings section
    • Look for DHCP Reservations or Static Leases option
    • Click Add Reservation or Add Static Lease
  4. Add Each Reservation:

    For each device:

    • IP Address: Enter the static IP (e.g., 192.168.11.10)
    • MAC Address: Enter the device MAC address
    • Hostname (optional): Enter device name (e.g., ML110, R630-01)
    • Click Save or Add
  5. Verify Reservations:

    • Review the list of reservations
    • Ensure all 6 reservations are listed
    • Verify IP addresses and MAC addresses are correct

Method 2: Via Clients/Devices

  1. Access Client List:

    • Go to Clients or Devices in the main menu
    • Find the device in the list
  2. Configure Static IP:

    • Click on the device
    • Look for Network or IP Configuration settings
    • Select Use Fixed IP Address
    • Enter the static IP address
    • Select network: MGMT-LAN (VLAN 11)
    • Save changes
  3. Repeat for Each Device:

    • Configure static IP for each device
    • Ensure they're all on VLAN 11 (MGMT-LAN)

Obtaining MAC Addresses

From UniFi Controller

  1. Via Clients List:

    • Go to Clients in UniFi Network
    • Find the device in the list
    • MAC address is displayed in device details
  2. Via Devices List:

    • Go to Devices in UniFi Network
    • Select the device
    • MAC address is shown in device information

From Devices Themselves

Linux/Unix:

ip link show
# or
ifconfig

Windows:

ipconfig /all

Proxmox:

cat /sys/class/net/*/address
# or
ip link show

Verification

After configuring static IP reservations:

  1. Check DHCP Leases:

    • Go to SettingsNetworksMGMT-LAN
    • View Active Leases or DHCP Clients
    • Verify devices are using the reserved IP addresses
  2. Test Connectivity:

    • Ping each static IP address
    • Verify devices respond on their reserved IPs
    • Test SSH/management access to each device
  3. Check Device Configuration:

    • Ensure devices are set to use DHCP (not static IP configuration)
    • Devices should automatically receive their reserved IP addresses

Troubleshooting

Device Not Getting Reserved IP

Possible Causes:

  • MAC address mismatch
  • Device not on VLAN 11
  • DHCP reservation not saved/enabled
  • Device configured with static IP instead of DHCP

Solutions:

  1. Verify MAC address is correct
  2. Check device is connected to MGMT-LAN network
  3. Verify reservation is enabled in network settings
  4. Ensure device is set to use DHCP (not static IP)

IP Address Already in Use

If IP address conflict:

  • Check if another device is using the IP
  • Verify no duplicate reservations
  • Release DHCP lease for conflicting device
  • Wait for DHCP lease to expire or manually release

Reservation Not Showing in Active Leases

  • Wait a few minutes for DHCP lease renewal
  • Disconnect and reconnect device
  • Release and renew DHCP lease on device
  • Check reservation is enabled and saved

Alternative: Static IP Configuration on Devices

If DHCP reservations are not available or preferred, configure static IPs directly on devices:

Proxmox (ML110)

  1. Via Web Interface:

    • Go to SystemNetwork
    • Edit the network interface
    • Set IP address: 192.168.11.10/24
    • Set Gateway: 192.168.11.1
    • Set DNS: 8.8.8.8, 1.1.1.1
  2. Via Command Line:

    # Edit network configuration
    nano /etc/network/interfaces
    # or for Netplan (Ubuntu)
    nano /etc/netplan/*.yaml
    

R630 Nodes

Configure static IP on each node:

  • IP: 192.168.11.11 (R630-01), 192.168.11.12 (R630-02), etc.
  • Netmask: 255.255.255.0 or /24
  • Gateway: 192.168.11.1
  • DNS: 8.8.8.8, 1.1.1.1


Last Updated: 2025-01-20