---
title: Install openstack-network-agents on Linux | Snap Store
description: Get the latest version of openstack-network-agents for Linux - OpenStack
  networking agents and helpers for OVS/OVN environments
url: https://snapcraft.io/openstack-network-agents
---

# openstack-network-agents

[Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")

* [Canonical](https://snapcraft.io/publisher/canonical "View all snaps from Canonical")
* [Server and Cloud](https://snapcraft.io/search?categories=server-and-cloud)

2024.1/stable 2024.1-ccb154a1

Install 2024.1/stable of openstack-network-agents

---

**Install using the command line**

```
sudo snap install openstack-network-agents
```

Don't have snapd? [Get set up for snaps](https://snapcraft.io/docs/installing-snapd).

---

### Package name

* openstack-network-agents

---

### License

* Apache-2.0

---

### Last updated

* 3 July 2026 - 2024.1/stable
* 27 August 2026 - 2026.1/edge

---

##### Report a Snap Store violation

* [Report this Snap](https://snapcraft.io/openstack-network-agents#report-snap-modal)

---

* [Description](https://snapcraft.io/openstack-network-agents#tab-description)
* [Security](https://snapcraft.io/openstack-network-agents#tab-security)

#### OpenStack networking agents and helpers for OVS/OVN environments

A snap that packages the networking agents and
utilities needed to run OpenStack on hosts with Open vSwitch (OVS) and OVN.
It is designed to be co-located with MicroOVN (<https://github.com/canonical/microovn>)
and is part of the Sunbeam (<https://canonical-openstack.readthedocs-hosted.com/en/>) project.

What it does

* **Provider-bridge management**: Creates OVS bridges, attaches physical NICs, and configures OVN physnet mappings for external network connectivity.
* **NIC discovery**: Identifies candidate uplink interfaces, filtering out virtual devices and bond members.
* **CLI**: Provides `setup-bridge`, `show-bridge-setup`, and `list-nics` subcommands for manual inspection and one-shot configuration.

Prerequisites

* Ubuntu 24.04 (Noble) or later
* MicroOVN installed and the
  `ovn-chassis` content interface connected

Install

```
sudo snap install openstack-network-agents
```

Configuration

The snap is configured through `snap set` keys and is typically driven by a
Juju subordinate charm. All keys live under the `network.*` namespace:

* `network.bridge-mapping` *(unset)*: Comma-separated `bridge:physnet:interface` triples. This is the **preferred** way to configure mappings.
* `network.enable-chassis-as-gw` (`true`): Register this chassis as an OVN gateway router.
* `network.external-bridge-address` (`0.0.0.0/0`): Static CIDR to assign to the bridge in localnet (single-node) mode.
* `logging.debug` (`false`): Enable debug logging for hooks and CLI.

Example:

```
sudo snap set openstack-network-agents  network.bridge-mapping="br-ex:physnet1:enp6s0"
```

CLI usage

The snap ships the `openstack-network-agents` command with several subcommands.

list-nics

List candidate uplink NICs (physical, bond, and VLAN interfaces that are not
already claimed):

```
openstack-network-agents list-nics              # JSON (default)
openstack-network-agents list-nics -f table      # human-readable table
```

setup-bridge

Apply the current snap configuration to create/update OVS bridges and physnet
mappings:

```
openstack-network-agents setup-bridge
```

show-bridge-setup

Display the current OVS bridge-to-physnet mappings detected on the host:

```
openstack-network-agents show-bridge-setup
```

---

## Install openstack-network-agents on your Linux distribution

Choose your Linux distribution to get detailed installation instructions. If yours is not shown, get more details on the [installing snapd documentation](https://snapcraft.io/docs/installing-snapd).

[### Arch Linux](https://snapcraft.io/install/openstack-network-agents/arch)

[### CentOS](https://snapcraft.io/install/openstack-network-agents/centos)

[### Debian](https://snapcraft.io/install/openstack-network-agents/debian)

[### elementary OS](https://snapcraft.io/install/openstack-network-agents/elementary)

[### Fedora](https://snapcraft.io/install/openstack-network-agents/fedora)

[### KDE Neon](https://snapcraft.io/install/openstack-network-agents/kde-neon)

[### Kubuntu](https://snapcraft.io/install/openstack-network-agents/kubuntu)

[### Manjaro](https://snapcraft.io/install/openstack-network-agents/manjaro)

[### Pop!\_OS](https://snapcraft.io/install/openstack-network-agents/pop)

[### openSUSE](https://snapcraft.io/install/openstack-network-agents/opensuse)

[### Red Hat Enterprise Linux](https://snapcraft.io/install/openstack-network-agents/rhel)

[### Ubuntu](https://snapcraft.io/install/openstack-network-agents/ubuntu)

[### Raspberry Pi](https://snapcraft.io/install/openstack-network-agents/raspbian)