Unraid Reset Network Settings - Install

Here’s a helpful article on resetting network settings in Unraid, especially useful if you’ve changed something that broke access to the web GUI or if you’re moving the USB drive to different hardware.

3. User Stories

  1. The "Locked Out" Admin:

    • Situation: Admin changed the static IP to a different subnet and lost connection.
    • Action: Reboots server. Selects "Network Reset" from the boot menu.
    • Result: Server boots, grabs a DHCP IP from the router. Admin logs in via the new IP, fixes the static IP settings, and saves.

  2. The Hardware Swapper:

    • Situation: Moved the USB drive to a completely new PC with a different motherboard/NIC.
    • Action: Boots the server.
    • Result: Unraid detects the hardware mismatch, resets network rules, and enables DHCP. No manual terminal editing required to regain access.

Method C — Restore network settings from config backup or rebuild network.cfg (recover corrupted config)

  1. Stop the array.
  2. Mount the Unraid flash drive on another machine or access it via local console.
  3. Locate /config/network.cfg on the flash drive. If corrupt or missing, you can restore from a backup:
    • Unraid creates automatic backups of config files in /config/backup* — copy the most recent network.cfg to /config/network.cfg.
  4. If no backup exists, create a minimal working network.cfg for DHCP (example): 
    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"
    Save as /config/network.cfg.
  5. Reboot the server.
  6. Verify network in the GUI or via console (ip addr, ip route, ping).

Step 2: Boot from USB

  1. Insert the USB: Plug the USB drive into your server.
  2. Reboot Server: Restart your server and enter the BIOS settings (usually by pressing F2, F12, or DEL).
  3. Change Boot Order: Set the USB drive as the first boot device.
  4. Save and Exit: Save your changes and exit the BIOS settings. Your server should now boot from the USB.

Method B — Reinstall or reload network drivers (when NIC not detected)

  1. Identify the NIC chipset and driver:
    • From Unraid console run: 
      lspci -k | grep -A 3 -i ethernet
  2. Check current kernel module: 
    lsmod | grep <module_name>
  3. If module not loaded, try loading it: 
    modprobe <module_name>
  4. If the driver is missing or incompatible (common after kernel updates), install the appropriate driver plugin or package:
    • Prefer using the Unraid Community Applications plugin to find updated driver plugins.
    • For manual installs, download the correct kernel module tarball for your Unraid kernel and follow the driver's README (usually copy .ko into /lib/modules/uname -r/extra and run depmod -a).
  5. After installing/loading driver, restart networking: 
    /etc/rc.d/rc.inet1 restart
    or reboot.
  6. Confirm the NIC appears: 
    ip link show

Notes:

Part 4: Resetting Network During a Fresh Unraid Installation

Sometimes, a "reset" doesn’t just mean fixing configs — it means a complete reinstall of Unraid while either keeping or wiping network presets. unraid reset network settings install

Final Steps

  1. Restore Data: If you backed up your data, now's the time to restore it. Be cautious to avoid overwriting any configuration changes.
  2. Update and Secure: Ensure your UnRAID server is updated and consider implementing additional security measures.