Problem: Users frequently lock themselves out of their Unraid servers by misconfiguring network settings (e.g., changing IP ranges, breaking bondings, or VLAN misconfigurations). Currently, recovering from this requires physically accessing the machine, connecting a monitor/keyboard, and using the Linux command line, which is intimidating for many users. Solution: A boot-time utility that allows the user to reset network configurations to "DHCP/Default" state or enter a specific "Install Mode" without requiring a terminal or physical monitor interaction (if supported by the motherboard/IPMI).
You want to reinstall Unraid on your existing USB drive but keep your disk array assignments, shares, and dockers — but you want to reset the network from scratch.
This is the perfect "reset network settings install" workflow because it resembles a new install but preserves your data integrity.
If you want, tell me which Unraid version and NIC model (or paste the output of lspci -k | grep -A 3 -i ethernet) and I’ll provide exact commands and a driver recommendation.
To reset your Unraid network settings to the default state, you must delete the configuration file from your boot flash drive. This forces Unraid to regenerate a standard DHCP configuration upon the next boot. The Direct Fix
The network settings are stored in a single file on your USB boot drive:/boot/config/network.cfg Step-by-Step Reset Procedure Method 1: Using a different computer (Recommended) Shutdown your Unraid server. Remove the USB flash drive. Plug the USB into a PC or Mac. Navigate to the config folder on the drive. Delete (or rename to .bak) the file named network.cfg. Eject the drive and plug it back into the server. Boot the server; it will now request a new IP via DHCP. Method 2: Via Terminal (If you have local access) If you have a monitor and keyboard attached to the server: Log in at the command prompt (usually root). Type: rm /boot/config/network.cfg Type: reboot Important Considerations
Static IPs: Any custom static IP you previously set will be lost.
Bonding/Bridging: Settings for LACP, eth0, or custom bridges (br0) will reset to defaults. unraid reset network settings install
Access: After rebooting, check your router’s client list to find the new IP address assigned to the server.
WebGUI: Use the new IP or http://tower.local (if using the default hostname) to log back in.
📍 Key Point: Deleting network.cfg only resets the connection settings; it does not touch your data, plugins, or Docker configurations. If you'd like, let me know: If you are unable to find the server's new IP If you are trying to set up a specific VLAN or Bond If you are locked out of the WebGUI even after a reset
To reset your Unraid network settings to the installation defaults, you must remove the specific configuration files from your boot flash drive. This is often necessary if you have lost access to the WebGUI after a router change, a failed static IP assignment, or incorrect bonding/bridging setups Quick Reset Method
If you cannot reach the WebGUI, the fastest way to revert to default (DHCP) settings is to delete the network configuration files directly from the USB boot drive. your Unraid server cleanly if possible. Remove the USB flash drive and plug it into a separate PC or Mac. Navigate to the folder on the USB drive. (or rename for backup) the following files: network.cfg — Contains IP, DNS, and gateway info. network-rules.cfg — Contains MAC address and interface mapping.
the USB into your server and reboot. Unraid will automatically recreate these files with default Alternative: Terminal/Local GUI Access
If you have a monitor and keyboard attached to the server, you can reset settings without moving the USB drive. Local GUI Mode : Reboot the server and select Unraid OS GUI Mode Problem: Users frequently lock themselves out of their
from the boot menu. This launches a local browser where you can navigate to Settings > Network Settings to fix the configuration. Command Line (CLI) : Log in as and run the following commands to clear the settings:
rm /boot/config/network.cfg rm /boot/config/network-rules.cfg reboot Use code with caution. Copied to clipboard Troubleshooting Connection Issues Identify Your IP
: After resetting, check your server's monitor during boot; it will display the new DHCP-assigned IPv4 address. DNS Failures
: If you can reach the WebGUI but the server can't see the internet (e.g., Community Applications won't load), manually set static DNS addresses to Settings > Network Settings Bonding & Bridging
: If you have multiple NICs, the default installation typically enables "Bonding." If your switch does not support LACP/802.3ad, you may need to disable bonding in the Unraid Network Settings to regain stability. or setting up a static IP reservation in your router? UNRAID Setup Guide. PLUS! Intro to Docker Apps and VM's!
To reset your Unraid network settings to their original install defaults, you can follow these steps. This is a highly useful feature
for troubleshooting connection issues, moving to a new network, or clearing out old hardware assignments without a full reinstall. How to Reset Network Settings Boot the server
The most effective way to reset networking is by deleting the specific configuration files from your boot drive. will automatically recreate these with default DHCP settings upon the next boot. Shutdown your server and remove the Unraid USB boot flash drive
Plug the USB drive into a separate PC (Windows, Mac, or Linux). Navigate to the folder on the USB drive. Delete (or rename) the following files: network.cfg (contains IP, Gateway, and DNS settings) network-rules.cfg (contains MAC address and interface assignments)
Safely eject the USB drive and plug it back into your Unraid server. Reboot the server . It will now attempt to get a new IP address via DHCP. Useful Features & Tips UGREEN NAS Experts - Facebook
Resetting Network Settings and Reinstalling on UnRAID
If you're experiencing issues with your UnRAID server and need to reset the network settings or perform a clean reinstall, this guide is for you. Below, we'll walk through the steps to reset your network settings and how to reinstall UnRAID, ensuring you can get your server up and running smoothly.
IFNAME[0]="eth0"
MAC[0]="00:11:22:33:44:55" # replace with your NIC MAC (optional)
NM_CONTROLLED="no"
USE_DHCP="yes"
IPADDR="0.0.0.0"
GATEWAY="0.0.0.0"
DNS_SERVER="0.0.0.0"
To set a static IPv4 quickly, from the Unraid web GUI:
Navigate to /config/ on the USB drive.
Delete (or rename to *.old):
Currently, Unraid has a "Safe Mode" that disables plugins. This feature adds a dedicated "Network Reset" option to the Syslinux boot menu.