Skip to main content
Version: 0.5.0

Network Bridge on Ubuntu

Using Netplan for Persistent Configuration​

A bridge created by a netplan file will persist after reboot. A basic Ubuntu install creates a netplan file at:

  • /etc/netplan/00-installer-config.yaml (Ubuntu 20.04/22.04)
  • /etc/netplan/50-cloud-init.yaml (Ubuntu 24.04)

This file can be edited to add the br0External bridge.

  1. Edit netplan
sudo nano /etc/netplan/00-installer-config.yaml
  1. Check for errors
sudo netplan generate
  1. Apply netplan
sudo netplan apply
warning

If the node’s IP address changes after registration, its configuration must be updated in Cluster Wizard or Node Client.

Example: Bridge using DHCP​

This example creates the br0External bridge using the eno1 interface and configures the bridge via DHCP.

network:
  ethernets:
    eno1:
      dhcp4: false
  bridges:
    br0External:
      interfaces:
        - eno1
      dhcp4: true
  version: 2

Example: Bridge with Static IP​

This example creates the br0External bridge using the enp81s0f0 interface and configures the bridge with a static IP address, nameserver, and default route.

network:
  ethernets:
    enp81s0f0:
      dhcp4: false
  bridges:
    br0External:
      interfaces:
        - enp81s0f0
      addresses:
        - 192.168.1.2/16
      nameservers:
        addresses:
          - 192.168.1.1
      routes:
        - to: default
          via: 192.168.1.1
      dhcp4: false
      dhcp6: false  
  version: 2