Unraid Reset Network Settings Install May 2026

Best for: Users who cannot access the WebGUI and do not have a monitor/keyboard attached (Headless setup).

Since Unraid stores its configuration files in plain text on the boot flash drive, you can edit them on any Windows or Mac computer.

Steps:

Before you begin:

For users with physical access (or SSH via another interface), a simplified command-line tool.

Problem: Users frequently lock themselves out of their Unraid servers by misconfiguring network settings (e.g., changing IP ranges, breaking bondings, or VLAN misconfigurations). Currently, recovering from this requires physically accessing the machine, connecting a monitor/keyboard, and using the Linux command line, which is intimidating for many users. Solution: A boot-time utility that allows the user to reset network configurations to "DHCP/Default" state or enter a specific "Install Mode" without requiring a terminal or physical monitor interaction (if supported by the motherboard/IPMI).

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 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. unraid reset network settings install

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 Best for: Users who cannot access the WebGUI

network-rules.cfg (Note: This file may not exist on all systems).

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

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 Before you begin: For users with physical access

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]