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!
Based on your request, I have interpreted this as a design for a new feature for Unraid OS. This feature addresses the common scenario where a user needs to reset network settings, often as a precursor to a clean installation or troubleshooting connectivity issues that prevent access to the GUI. Here is a Feature Specification for "Network Configuration Reset & Install Mode."
Feature Specification: Network Configuration Reset & Install Mode 1. Overview 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). 2. Core Components A. The "Network Safe Mode" (Boot Menu Option) Currently, Unraid has a "Safe Mode" that disables plugins. This feature adds a dedicated "Network Reset" option to the Syslinux boot menu.
Location: Unraid Boot Menu (GUI/Text mode). Trigger: User selects Network Reset from the boot menu. Functionality: unraid reset network settings install
The OS boots normally but bypasses the network.cfg file. It generates a temporary configuration:
Interface: Sets the primary interface (eth0) to DHCP. Bonding: Disabled. Bridge: Disabled (br0).
Notification: Once booted, the Unraid WebGUI displays a prominent yellow banner: "Network Reset Mode Active. Configuration has been reverted to DHCP defaults. Please verify settings." To reset your Unraid network settings to the
B. The network-reset Command (Terminal Tool) For users with physical access (or SSH via another interface), a simplified command-line tool.
Command: network-reset Flags:
--dhcp : Forces all interfaces to request DHCP IP addresses immediately. --static [IP] : Temporarily assigns a static IP to eth0 for setup purposes (e.g., network-reset --static 192.168.1.50 ). --clean : Deletes the existing network.cfg and network-rules.cfg files from the USB boot drive and halts the network service for a restart. Remove the USB flash drive and plug it
C. "Install Mode" Integration This facet of the feature streamlines the process when moving a USB drive to new hardware or performing a fresh install.
Scenario: User plugs the Unraid USB into a new server. Feature: On first boot on new hardware, Unraid detects that MAC addresses in network-rules.cfg do not match the physical hardware. Automated Action: