I changed the network settings and lost access: sawing the branch you sit on
Network configuration is applied over the very connection you are using to apply it. A small mistake cuts the connection at the moment of applying, and without a prepared way back you need physical access.
AtlasPVE ·
This entry answers
- proxmox no access after network change
- proxmox locked myself out
- proxmox interfaces file broken
- proxmox ifreload hangs
- proxmox revert network change
You corrected the address, you applied it, and the panel went silent. This is the most common way people lock themselves out of a server, and the reason is simple: the network setting is applied over the connection you are using to apply it. You are sawing the branch you sit on.
Three preparations before changing anything
One: a second way in that the change cannot affect. A physical console, the server's own out-of-band management card, or a second network card on a different bridge. If you have none of these, what you are about to do is an irreversible operation, whatever it is called.
Two: knowing what "back" looks like. Keep a copy of the current configuration. "I'll remember" is not remembered in the moment of panic.
Three: one change at a time. Change two things at once and you cannot tell which one cut the connection, and trial and error is expensive on a machine you have to walk to.
Before the change, record a known-good state from the Proxmox host console:
cp -a /etc/network/interfaces /root/interfaces.before-network-change
ip -br link
ip -br address
ip routeKeep a second terminal open and know the management client's IP address. The first command gives you a recovery file; the other three capture the interface names, addresses and default route that must still exist after the change.
Common mistakes
Asking an isolated bridge to reach the external network. A bridge with no physical port can be valid for an internal-only network, but it cannot reach an external DHCP server or upstream gateway by itself. A DHCP wait can make an apply appear stuck even though the bridge definition is syntactically valid.
The port name changing. Physical card names can shift when hardware changes or after certain upgrades. If the name in the configuration no longer exists on the machine, the bridge sits empty.
Changing the address and forgetting the gateway. Or the reverse. The machine comes up, sees its own network, and cannot get out.
Putting a tag on the management interface. Right in one direction, silence in the other. Because tagging produces no error, this is also the one noticed last.
Apply and verify without adding a second outage
On current Proxmox VE installations, the web interface stages network changes in /etc/network/interfaces.new; Apply Configuration moves them into /etc/network/interfaces and applies them with ifupdown2. If you deliberately edit the live file from a console, the supported reload is:
ifreload -aDo not use ifdown vmbr0 followed by ifup vmbr0 on a production bridge: taking the bridge down interrupts every guest attached to it. After applying, verify from the console before closing your rescue path:
ip -br address
ip route
ip route get <MANAGEMENT_CLIENT_IP>
ss -ltn | grep ':8006'The new management address, correct return route to your client and a listener on port 8006 are the local success conditions. Also reconnect from a separate machine; a host checking only itself cannot prove that the VLAN and upstream switch agree.
If you are already locked out
The honest answer: you need physical access or an out-of-band route. Rebooting does not rescue you either, because the machine comes up with the file on disk and that file is still broken. A reboot helps only if you have already fixed that file.
From that console, restore the known-good file and reload it:
cp -a /root/interfaces.before-network-change /etc/network/interfaces
ifreload -a
ip -br address
ip routeIf you changed the management IP intentionally, reconnect to the new address rather than declaring failure when the old browser tab goes silent. Keep the recovery file until remote access and guest connectivity have both been verified.
What Atlas does
When Atlas applies a network configuration it starts a rollback countdown: if you do not confirm within the set time, the old configuration comes back on its own. What matters is who holds that countdown. The countdown is set on the system's own timer, not on Atlas itself, so even if the Atlas service crashes at that moment the rollback still runs. A safety net that depends on the survival of the software making the change is not a safety net.
Second, Atlas refuses up front any configuration that would make rollback impossible. If an address is requested on a bridge with no physical port, the operation stops before being applied, because that combination locks the apply step, and a locked step cannot even write the rollback record. This check sits on the server rather than in the interface, so a request sent by hand hits the same wall.
Sources
Proxmox's own documentation. In English, and it has the final word on this subject.