DHCP conflicts
Troubleshooting
What Are DHCP Conflicts?
DHCP conflicts arise when multiple devices on a network are inadvertently assigned the same IP address, leading to network connectivity issues. In Pi-hole environments, these conflicts typically occur when there are multiple DHCP servers, overlapping IP ranges, or misconfigured DHCP settings.
Common Causes and Solutions
1. Multiple Active DHCP Servers
When both Pi-hole and your router attempt to manage DHCP, network conflicts are inevitable. To resolve this:
- Choose one DHCP server (either Pi-hole or your router)
- If using Pi-hole for DHCP, disable your router's DHCP service
- If using your router, disable Pi-hole's DHCP service through Settings > DHCP
2. DHCP Range Configuration
Poorly configured DHCP ranges often lead to IP conflicts. To prevent this:
- Define a specific DHCP range (e.g., 192.168.1.100-192.168.1.200)
- Ensure all static IP assignments fall outside this range
- Document your IP allocation strategy
3. Static IP Management
Static IP conflicts occur when manually assigned addresses overlap with DHCP assignments. To address this:
- Review all static IP assignments across your network
- Use Pi-hole's Static DHCP Leases Configuration for centralized management
- Maintain documentation of all static IP assignments
4. Device Configuration Issues
Problems often arise when devices have manual IP configurations that conflict with DHCP assignments. Best practices include:
- Managing static assignments through Pi-hole's DHCP system
- Configuring static leases via Settings > DHCP > Static Leases
- Regularly auditing device network settings
5. DHCP Lease Management
Stale DHCP leases can cause persistent conflicts. To clear these:
- Restart the Pi-hole FTL service:
sudo service pihole-FTL restart - Review and adjust lease duration settings
- Monitor lease assignments regularly
6. Network Device Synchronization
After DHCP changes, devices may retain outdated IP configurations. To ensure proper synchronization:
- Reboot all network devices after significant DHCP changes
- Release and renew IP addresses on critical devices
- Verify new configurations take effect
7. VLAN Considerations
In networks with VLANs, IP range overlaps can cause conflicts. Ensure:
- Proper VLAN segmentation
- Distinct IP ranges for each VLAN
- Appropriate Pi-hole DHCP configuration for each network segment
8. Lease Timing Configuration
Inappropriate lease durations can lead to assignment conflicts. To optimize:
- Adjust DHCP lease times based on network size and device turnover
- Monitor lease usage patterns
- Configure appropriate renewal timings
Troubleshooting Resources
For effective DHCP conflict resolution, utilize these tools:
- Pi-hole Query Logs for DHCP assignment tracking
- System logs at
/var/log/pihole.logfor detailed error information - Network scanning tools like
nmapfor IP conflict detection
Regular monitoring and proactive management of these settings will help maintain a stable network environment.
Something here not working for you? Ask in the community — other makers and the Little Bird team read it.