--- title: Install openstack-network-agents on elementary OS using the Snap Store | Snapcraft description: Get the latest version of openstack-network-agents for on elementary OS - OpenStack networking agents and helpers for OVS/OVN environments url: https://snapcraft.io/install/openstack-network-agents/elementary --- [Canonical Snapcraft](https://snapcraft.io/) # Install openstack-network-agents on **elementary OS** # 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) [Install](https://snapcraft.io/install/openstack-network-agents/elementary#install) #### 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 () and is part of the Sunbeam () 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 ``` ### 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/install/openstack-network-agents/elementary#report-snap-modal) --- ## Enable snaps on elementary OS and install openstack-network-agents Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully. Snaps are discoverable and installable from the [Snap Store](https://snapcraft.io/store), an app store with an audience of millions. ### Enable snapd Snap can be installed on elementary OS from the command line. Open *Terminal* from the Applications launcher and type the following: ``` sudo apt update sudo apt install snapd ``` Either log out and back in again, or restart your system, to ensure snap’s paths are updated correctly. ### Install openstack-network-agents To install openstack-network-agents, simply use the following command: ``` sudo snap install openstack-network-agents ``` ### Other popular snaps… [See more...](https://snapcraft.io/search?categories=featured) [See more in Featured](https://snapcraft.io/search?categories=featured) ### More things to do… #### [Get the snap store](https://snapcraft.io/snap-store) Browse and find snaps from the convenience of your desktop using the snap store snap. #### [Learn more about snaps](https://snapcraft.io/docs) Interested to find out more about snaps? Want to publish your own application? Visit [snapcraft.io](https://snapcraft.io/) now. [Back to top](https://snapcraft.io/install/openstack-network-agents/elementary) © 2026 Canonical Ltd. Ubuntu and Canonical are registered trademarks of Canonical Ltd. Powered by [Charmed Kubernetes](https://www.ubuntu.com/kubernetes) [Join the forum](https://forum.snapcraft.io/), contribute to or report problems with, [snapd](https://bugs.launchpad.net/snapd), [Snapcraft](https://bugs.launchpad.net/snapcraft), or [this site](https://github.com/canonical/snapcraft.io/issues/new). * [Share on Twitter](https://twitter.com/snapcraftio) * [Share on Facebook](https://www.facebook.com/snapcraftio) * [Share on YouTube](https://www.youtube.com/snapcraftio) * [Terms of Service](https://ubuntu.com/legal/terms-and-policies/snap-store-terms) * [Data privacy](https://www.ubuntu.com/legal/data-privacy) * [Manage your tracker settings](https://snapcraft.io/install/openstack-network-agents/elementary) * [Service status](https://status.snapcraft.io/) * [Other functions](https://dashboard.snapcraft.io/) * [Contact us](https://snapcraft.io/about/contact-us)