rm /boot/config/network-rules.cfg
(Clears MAC-to-interface mapping; useful if you changed NICs.)
Delete or rename the config file and reboot:
rm /boot/config/network.cfg
reboot
After reboot, Unraid generates a new file with DHCP enabled on the first active NIC.
Network issues can feel like a complete roadblock when managing a home server. Whether you have just changed your router, misconfigured a static IP, or lost access to the web GUI after an update, knowing how to reset your Unraid network settings is a critical skill. This guide covers the most effective methods to get your server back online, ranging from simple command-line fixes to the "nuclear option" of deleting configuration files. Why You Might Need a Network Reset
There are several scenarios where your Unraid network configuration might break:
Static IP Conflicts: You assigned a static IP that is now being used by another device.
Hardware Changes: You installed a new NIC (Network Interface Card) or changed your motherboard.
Subnet Mismatch: You moved your server to a new network with a different IP scheme (e.g., moving from 192.168.1.x to 10.0.0.x).
Incorrect Bonding/Bridging: Enabling LACP or complex bridging without proper switch support can lock you out of the WebUI. Method 1: The "Fresh Start" (Recommended)
If you cannot access the Unraid web interface, the most reliable way to fix the issue is to force the server back to its default DHCP settings. This involves deleting the configuration file from your boot flash drive.
Power down the server: If you have a monitor and keyboard attached, type poweroff. If not, a short press of the physical power button should trigger a clean shutdown.
Remove the Flash Drive: Take the Unraid USB boot drive and plug it into a different computer (Windows, Mac, or Linux).
Navigate to the Config Folder: Open the flash drive and locate the folder named config. unraid reset network settings
Delete (or Rename) network.cfg: Find the file named network.cfg.
Tip: Rename it to network.cfg.bak instead of deleting it. This gives you a backup of your old settings.
Clean up extra files: If you see files named network-rules.cfg or extra.cfg, delete or rename those as well.
Reinsert and Boot: Plug the USB back into your Unraid server and power it on.
Unraid will see that the network configuration is missing and automatically create a new one using DHCP. Your router will assign the server a new IP address. Method 2: Using the Local Terminal
If you have a monitor and keyboard plugged directly into your Unraid server (and you are not running "Headless"), you can reset the settings without moving the USB drive.
Log In: At the command prompt, log in with your root username and password.
Stop the Network Service: Type the following command:/etc/rc.d/rc.inet1 stop Navigate to the Config Directory:cd /boot/config
Delete the Config Files:rm network.cfg(Optional: rm network-rules.cfg) Reboot the Server:reboot Upon reboot, Unraid will generate a default configuration. Method 3: Unraid GUI Mode (Local Desktop)
If your server has a graphics card and you are stuck, you can boot into "Unraid OS GUI Mode" from the boot menu. Restart the server.
Select "Unraid OS GUI Mode" from the blue bootloader screen.
Log in locally: The server will boot into a basic desktop environment and open a web browser pointing to localhost. rm /boot/config/network-rules
Navigate to Settings > Network Settings: Since you are "inside" the server, you don't need a network connection to access the interface.
Correct your errors: Change your IP back to DHCP or fix the gateway/DNS settings. Apply and Reboot: Switch back to the standard boot mode. Troubleshooting Post-Reset Tips
Once you have reset your settings and regained access, follow these best practices to prevent future lockouts:
Set a Static IP via Router (DHCP Reservation): Instead of setting a static IP inside Unraid, tell your router to always give the server's MAC address the same IP. This prevents "invisible" IP conflicts.
Verify DNS Settings: If your server has local access but cannot download plugins or updates, ensure your DNS is set to something reliable like 8.8.8.8 or 1.1.1.1.
Eth0 vs Eth1: If you have multiple LAN ports, Unraid might assign the "wrong" one as eth0. You can swap these in the Settings > Network Settings > Interface Rules section.
Resetting network settings in Unraid is a standard troubleshooting step when you lose access to the WebGUI or change your hardware setup. There is no single "Reset" button in the interface for this; instead, you must manually clear configuration files from the boot drive The Reset Process
If you cannot access your server via the network, the most effective method is to delete the existing configuration files on the flash drive. File Locations: Browse to the folder on your Unraid USB flash drive. Files to Delete/Rename: network.cfg : Reverts basic IP and DHCP settings. network-rules.cfg
: Resets assignments for physical network interfaces (useful if you added a new NIC). The Result:
On the next reboot, Unraid will recreate these files with factory defaults, typically defaulting to for automatic IP assignment. Alternative: GUI Mode
If you have physical access to the server (monitor and keyboard), you can avoid the "blind" reset: Boot Option: Unraid OS GUI Mode from the boot menu. Direct Access:
This launches a local browser (Firefox) directly on the server, allowing you to fix settings via Settings → Network Settings without needing another computer. Common Use Cases & Tips (Clears MAC-to-interface mapping; useful if you changed NICs
What if you don’t have a monitor attached? What if your server is headless in a closet? You can still fix it using any other computer (Windows, Mac, Linux).
Step 1: Remove the Unraid USB Drive Properly power down the server by holding the power button (not ideal, but necessary if you can't SSH). Remove the bootable USB drive.
Step 2: Plug it Into Another Computer Your Unraid USB is formatted as FAT32 (or generally readable by any OS). Plug it in.
Step 3: Navigate to the Config Folder
Open the USB drive. You will see a folder named config. Inside that folder, look for two critical files:
Step 4: Delete or Edit the Files
Step 5: Safely Eject and Reboot Eject the USB drive, plug it back into your Unraid server, and boot. Congratulations—you are back on DHCP.
Edit /boot/config/network.cfg and set key values:
USE_DHCP="no"
IPADDR="192.168.1.100"
NETMASK="255.255.255.0"
GATEWAY="192.168.1.1"
Then reload networking:
/etc/rc.d/rc.inet1 restart
/etc/rc.d/rc.inetd restart
cat /boot/config/network.cfg
ifconfig -a
Once you have everything working perfectly, back up your healthy network config:
cp /boot/config/network.cfg /boot/config/network.cfg.good
If you break things again, you can copy that file back from the console instead of re-entering all your static IP details.
Unraid stores network settings primarily in /boot/config/network.cfg. Improper changes via the web GUI, plugin conflicts, or hardware changes (e.g., new NIC) can break remote access. When web GUI is inaccessible, administrators must use the local terminal (keyboard + monitor) or IPMI to recover.