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 route

Keep 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 -a

Do 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 route

If 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.

Related entries

How does this look inside Atlas?

Go to the product page