Users who cannot access the WebGUI and do not have a monitor/keyboard attached (Headless setup).
The quickest and safest way to fix your network is to let Unraid regenerate a clean, default configuration file. Step 1: Power Down Your Server
Since you cannot access the WebUI, you must safely shut down the system physically.
Insert the USB drive into a working desktop or laptop computer (Windows, Mac, or Linux). Step 3: Delete or Rename the Network Config Files Open the USB flash drive in your file explorer. Navigate to the folder named config . Locate the file named network.cfg .
If you use Docker containers that require their own IP addresses on your custom network, ensure that Enable bridging is set to Yes .
Network issues in Unraid are often simple to fix with a . It's like giving your server's network settings a clean slate. This guide covers three common scenarios: resetting during initial installation, when you're locked out of the WebGUI, and when you need to preserve custom Docker settings like VLANs.
Unraid OS 6.12.x ---------------------------------------- 1. Unraid OS (Normal) 2. Unraid OS (Safe Mode) - Disables plugins 3. Unraid OS (Network Reset) <-- NEW FEATURE (Resets IP to DHCP, clears bonding/bridging) 4. Memtest86+ ---------------------------------------- Select boot option: 3
Here is the complete, step-by-step guide to safely resetting your Unraid network settings without losing any of your data, Docker containers, or VMs. Method 1: The Headless Flash Drive Method (Fastest)
Instead of reinstalling the entire Unraid OS, a targeted network reset wipes only your network layout, leaving your data arrays, shares, dockers, and plugins completely untouched. Method 1: The Flash Drive Reset (Recommended)
Because you reset the network settings to default, your server will no longer use its old static IP address. It will request a temporary dynamic IP address from your router via DHCP. To log back in:
If you lost access to the web GUI but can still connect to your server via SSH or a local keyboard and monitor (GUI boot mode disabled), you can reset the network files directly from the Unraid terminal. Step 1: Log In as Root