How to edit Proxmox network configuration

If you need to change your Proxmox networking information, you have a few different options. This guide will assist you with changing your network.

CAUTION: Changing network settings on a working system can lock you out or make your system inaccessible! Double check network settings before applying as using the wrong IP space can create further issues.

Using the web GUI

You can update the network settings through the web interface.

This will work with other Proxmox products as well, however instead of clicking on the node, you'll find the network settings under "Administration" in most cases and instead of "vmbr0", you would select the physical network interface.

First, login to the Proxmox web console. Select your node and then click on Network. Click on the vmbr0 interface and then click on edit. Make your changes and then click the apply button (if you have ifupdown2 installed, otherwise you will need to reboot the server to apply the settings).

Note: Do not select the physical interface! The physical interface is bridged with a virtual interface and Proxmox uses the virtual interface.

Command line interface / SSH

It is not recommended to update your network settings over SSH. You can use your server's console to safely edit the settings and easily revert back if you enter the wrong information.

Proxmox is built on top of Debian and so standard Debian networking applies. You can edit the interfaces directly at

/etc/network/interfaces

The configuration file will look similar to this:

auto lo
iface lo inet loopback

iface enp5s0f0 inet manual

iface enp5s0f1 inet manual

auto vmbr0
iface vmbr0 inet static
        address x.x.x.x/x
        gateway x.x.x.x
        bridge-ports enp5s0f0
        bridge-stp off
        bridge-fd 0

auto vmbr1
iface vmbr1 inet manual
        bridge-ports none
        bridge-stp off
        bridge-fd 0

The lo and enp* entries are the loopback and physical interface(s), respectively. vmbr* are the virtual bridge interfaces. vmbr0 is the main bridge and will be what you configure your main network on. vmbr1 is a host-only virtual bridge. Do not bridge a host-only adapter to your main network interface.

Once you make changes, you can restart your network with the following command:

systemctl restart networking.service

Please keep in mind that your network connection will be interrupted while the networking service restarts. If there is a syntax error or configuration error and the network fails to restart, you will need to use your server's console or contact support for assistance.

Article Information

Article ID: 333
Category: Proxmox
Viewed 19,387 times.
Rating:

(4)
Was this article helpful?
Yes No
Help us improve this article!
Submit Feedback