proxmox/docs/04-configuration/UDM_PRO_DHCP_RESERVATIONS_GUIDE.md

# 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

### Method 1: Via Network Settings (Recommended)

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 **Settings** → **Networks**
   - 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:**
```bash
ip link show
# or
ifconfig
```

**Windows:**
```cmd
ipconfig /all
```

**Proxmox:**
```bash
cat /sys/class/net/*/address
# or
ip link show
```

---

## Verification

After configuring static IP reservations:

1. **Check DHCP Leases:**
   - Go to **Settings** → **Networks** → **MGMT-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 **System** → **Network**
   - 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:**
   ```bash
   # 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`

---

## Related Documentation

- [UDM_PRO_STATUS.md](./UDM_PRO_STATUS.md) - Configuration status
- [UDM_PRO_CONFIGURATION_CHECKLIST.md](./UDM_PRO_CONFIGURATION_CHECKLIST.md) - Complete configuration checklist

---

**Last Updated:** 2025-01-20