---
title: "Add Bridge Interface"
slug: "add-bridge-interface"
updated: 2026-05-19T13:21:39Z
published: 2026-05-19T13:21:39Z
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zpesystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Bridge Interface

With Bridge interfaces, the System can create a virtual switch that crosses one or more interfaces. The switch is completely transparent to the network interfaces and does not require additional setup. The most common use for a bridge network is easy network access for any running NFV (outside as well as the Nodegrid System). Bridge network interfaces use the same network configuration options as all Ethernet interfaces.

1. Go to the *NETWORK::CONNECTIONS*page
2. Click **Add** (displays dialog)
3. Enter **Name**
4. On **Type** drop-down, select **Bridge**(dialog changes)

![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1753887312117.png)
5. Enter **Description**
6. If **Connect Automatically** checkbox is selected, connection is automatically established at startup
7. Select **Set as Primary Connection** checkbox (defines interface as the primary connection. Only one interface can be the primary.)
8. Select **Block Unsolicited Incoming Packets** checkbox (automatically blocks all inbound connections on the interface)
9. In *Bridge Connection* menu, in the optional **Interface**field, enter the name of the bridge interface that will be created for this connection. If not entered, the interface will be called *brN*, where *N* is a number starting at 0 and automatically incremented as needed
10. In *Bridge Connection*menu, enter details:
  1. **Bridge Interfaces** (list of physical interfaces, separated by commas and/or spaces)
  2. **MAC Configuration**(default: **Use MAC from first interface**) (if selected, a text field shows where the user can enter a custom, persistent MAC address for this connection)
  3. **Enable Spanning Tree Protocol** checkbox
  4. **Hello Time (s)** (default: 2) (number of seconds a HELLO packet is sent when Spanning Tree is enabled)
  5. **Forward Delay (s)** (default: 5) (packet forward delay. Can be set to 0 when **Enable Spanning Tree Protocol** is not checked)
  6. **Max Age (s)** (default: 20) (maximum age for packages when Spanning Tree is enabled)
  7. **Ageing Time (s)**(default: 300) (how long the bridge will keep information about a specific address in its forwarding database)
11. In *IPv4 Mode*menu, select one:
  - **No IPv4 Address** radio button
  - **DHCP** radio button
  - **Static** radio button (if selected, expands dialog). Enter **IP Address**, **BitMask**, and (optional) **Gateway IP**

![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1678380082753.png)
  - Enter IPv4 details:
  - 
    - (optional) **IPv4 DNS Server**
    - **IPv4 DNS Search** (defines a domain name for DNS lookups)
    - **IPv4 Default Route Metric**
    - **Ignore obtained IPv4 Default Gateway** checkbox
    - **Ignore obtained DNS server** checkbox
12. In *IPv6 Mode*menu, select one:
  - **No IPv6 Address** radio button
  - **Link local Only** radio button.
  - **Address Auto Configuration** radio button
  - **Stateful DHCPv6** radio button
  - If Static radio button is selected, displays menu). Enter **IP Address**, **Prefix Length**, and (optional) **Gateway IP![](https://cdn.document360.io/763c5fb1-b9af-4ccd-9ad6-cf28ae4cd5a3/Images/Documentation/image-1678380303006.png)**
  - Enter IPv6 details:
  - 
    - (optional) **IPv6 DNS Server**
    - **IPv6 DNS Search** (defines domain name for DNS lookups)
    - **IPv6 Default Route Metric**
    - **Ignore obtained IPv6 Default Gateway** checkbox
    - **Ignore obtained DNS server** checkbox
13. Click **Save**.
