Once you have regained access, implement these safeguards:
Resetting network settings does not affect your disk data or array configuration. Your drives, shares, and Docker/VMs remain intact. The only thing lost is network customizations (static IP, bonding, VLAN tags).
If you have a complex network setup, recreate those settings carefully after regaining access.
To reset your Unraid network settings to their original "out-of-the-box" install defaults, you must delete or rename the network.cfg and network-rules.cfg files located in the /config folder on your boot flash drive. Removing these files forces Unraid to regenerate them using default DHCP settings upon the next reboot.
Blog Post: How to Reset Unraid Network Settings to Factory Defaults
If you’ve accidentally locked yourself out of your Unraid WebGUI by misconfiguring a static IP, messing up a bridge, or swapping network cards, don’t panic. You don't need to reinstall the entire OS. Here is a simple guide to resetting your network settings to the install defaults. Why Reset Your Network?
Lost Access: You assigned a static IP that no longer matches your router's subnet.
Hardware Swaps: You added a new NIC (Network Interface Card) and Unraid isn't picking it up as the primary.
Bonding Issues: Your attempt at link aggregation or VLAN tagging went wrong, breaking your connection. Method 1: The Offline Reset (Recommended)
This is the most reliable method if you cannot reach the WebGUI at all.
Shut Down Your Server: If possible, use the physical power button to trigger a clean shutdown.
Remove the Flash Drive: Pull the Unraid USB boot drive and plug it into a separate PC or Mac.
Navigate to the Config Folder: Open the flash drive and go into the /config directory. Delete (or Rename) the Files:
Find network.cfg and delete it (or rename it to network.cfg.old to keep a backup). unraid reset network settings install
Find network-rules.cfg (if it exists) and delete/rename it as well.
Reboot: Plug the USB back into your server and power it on. Unraid will boot up and automatically search for a DHCP address, just like a fresh install. Method 2: The Command Line (SSH or Local Terminal)
Use this method if you have a monitor and keyboard attached to the server or still have SSH access. Log In: Access the terminal (locally or via SSH). Run the Delete Command:
rm /boot/config/network.cfg rm /boot/config/network-rules.cfg Use code with caution. Copied to clipboard Reboot the Server: reboot Use code with caution. Copied to clipboard What Happens Next?
Once the server reboots, it will use DHCP to request a new IP address from your router. Check your router's client list or the server's local monitor to find the new IP. You can then log back into the WebGUI and re-configure your desired static IP or bonding settings under Settings > Network Settings.
Pro Tip: Always make a backup of your flash drive via the Main > Flash tab in Unraid before making major network changes. It can save you from a manual reset next time!
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 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 Once you have regained access, implement these safeguards:
: 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
If DHCP is broken on your router:
ip addr add 192.168.1.50/24 dev eth0
ip link set eth0 up
ip route add default via 192.168.1.1
Then access the WebGUI at 192.168.1.50 and set a permanent static IP via Settings > Network Settings.
Before diving into the "how," let's diagnose the "why." Common triggers for a network reset include:
When the WebGUI is unreachable, you cannot simply click a "Reset" button. You must work directly on the server console or modify the USB flash drive from another computer.
If you only want to reset network settings to default:
Before you begin:
Resetting network settings in Unraid is not a single "button press" operation, but it is straightforward once you understand the file-based architecture. Whether you are performing a full unraid reset network settings install — wiping everything for a new start — or simply recovering from a bad static IP configuration, the solution almost always involves deleting network.cfg and network-rules.cfg from the USB flash drive.
Final Pro Tip: Always keep a copy of your original network.cfg on your desktop. If you reset and need to revert, you can simply copy it back to the USB drive. This gives you the best of both worlds: a quick reset path and a rapid restore path.
Now go ahead — delete those files, reboot, and watch your Unraid server reappear on your network like magic. Resetting network settings does not affect your disk
Last updated: October 2025. Compatible with Unraid 6.12.x and 7.0.0+
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
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!
Title:
Resetting Network Settings in Unraid: A Clean Installation Approach
Author: [Your Name]
Date: [Current Date]