To reset your Unraid network settings to the installation defaults, the most effective method is to delete or rename the network configuration files located on your boot flash drive. This forces Unraid to recreate the default settings—typically DHCP—on the next boot. Quick Reset Method (Via Command Line)
If you have a monitor and keyboard attached to your server, you can perform the reset directly from the terminal: Log in as root. Navigate to the configuration directory: cd /boot/config/. Delete the network configuration files: rm network.cfg rm network-rules.cfg (if it exists) Reboot the server: reboot.
Upon restart, Unraid will automatically generate a new network.cfg with default DHCP settings. Alternative: Reset via Desktop PC
If you cannot access the server's command line, you can modify the USB boot drive on another computer: Shut down the Unraid server and remove the USB flash drive. Plug the USB drive into your PC or Mac. Open the drive and locate the /config folder. Rename network.cfg to network.cfg.old.
If present, rename network-rules.cfg to network-rules.cfg.old.
Safely eject the drive, plug it back into the server, and power it on. Reconfiguring Settings in the WebGUI
Once the server reboots and obtains a new IP address (which you can find on your router's client list or the server's local monitor), you can customize your settings: Unraidhttps://forums.unraid.net
Reset Network to default - General Support - Forums - Unraid
To reset your Unraid network settings to the install defaults (DHCP), you must remove the specific configuration files from your Unraid flash drive. This process is useful if you have lost access to the WebGUI due to a manual IP error or incorrect bonding/bridging setup. Method 1: Using Another Computer (Easiest)
If you cannot access your server at all, use this method to clear settings directly from the boot media. Shut down your Unraid server safely.
Remove the USB flash drive and plug it into a different PC or Mac. Open the flash drive and navigate to the /config folder. Locate and delete (or rename to .old) the following files: network.cfg
network-rules.cfg (Note: This file may not exist on all systems). unraid reset network settings install
Eject the USB drive safely, plug it back into your server, and power it on.
Unraid will automatically recreate these files with default DHCP settings. Method 2: Using the Command Line (Terminal)
If you have a monitor and keyboard physically connected to your server, you can perform the reset without moving the USB drive.
Log in at the local terminal prompt (default username is root).
Type the following commands to remove the configuration files:
rm /boot/config/network.cfg rm /boot/config/network-rules.cfg Use code with caution. Copied to clipboard Reboot the server by typing: reboot Use code with caution. Copied to clipboard
Once it reboots, check the screen for the new IP address assigned by your router. Method 3: Booting into GUI Mode Default network config? - General Support - Forums - Unraid
Restoring Connectivity: A Guide to Resetting Unraid Network Settings
In the complex ecosystem of home lab management, Unraid stands out for its flexibility and ease of use. However, even the most robust systems can encounter connectivity hurdles—whether due to a misconfigured static IP, a hardware change, or an accidental adjustment in the web interface. When you find yourself locked out of your server's GUI, performing a manual network reset is the most efficient path back to operational stability. The Logic of the Reset
Unlike traditional operating systems that hide configuration files deep within system partitions, Unraid stores its settings on the USB boot flash drive. This design is a lifesaver for troubleshooting. Most network issues are rooted in the network.cfg
file, which dictates how the server identifies itself to your router. By removing this file, you essentially "reinstall" the default network configuration, forcing Unraid to request a fresh DHCP address upon its next boot. The Step-by-Step Recovery Process To reset your Unraid network settings to the
To reset your network settings and regain access, follow these steps according to the official Unraid documentation Graceful Shutdown
: If possible, shut down your server via the GUI. If the GUI is inaccessible, a brief press of the power button usually triggers a clean shutdown. Avoid pulling the plug to prevent data corruption. Access the Flash Drive
: Remove the USB boot device from your server and plug it into a separate PC or Mac. Locate the Config Files : Open the USB drive and navigate to the Target the Culprits
: Find and delete (or move to a backup folder) the following files: network.cfg (contains IP and DNS settings) network-rules.cfg (stores MAC address to interface mapping) Reboot and Reconnect
: Safely eject the USB drive, plug it back into your Unraid server, and power it on. Conclusion
By clearing these configuration files, Unraid reverts to its "factory" network state, typically defaulting to a dynamic IP address via DHCP. You can then use the Unraid Forum's advice
to check your router's client list for the new IP or navigate to
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 /config/network
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!
On the USB, copy these folders/files to a safe location:
Note: If you want to preserve Docker/appdata, ensure appdata/VMs are on array disks and their configs are intact.
If you have a monitor and keyboard attached but don't want to reboot into safe mode:
root.killall emhttp
rm /boot/config/network.cfg
rm /boot/config/network-rules.cfg
/usr/local/sbin/emhttp &
ip a or ifconfig to see the newly assigned IP address. The WebGUI should now be accessible at http://[that-ip].If a full reinstall is required:
To set a static IPv4 quickly, from the Unraid web GUI:
Sometimes, a "reset" doesn’t just mean fixing configs — it means a complete reinstall of Unraid while either keeping or wiping network presets.