--- title: Introducing Netplan v1.0 – stable, declarative network management description: After more than 7 years of development, Netplan v1.0 delivers improved stability and maintainability alongside a host of other new features. url: https://canonical.com/blog/introducing-netplan-v1?format=md --- 1. [Blog](https://canonical.com/blog) 2. Article --- [Lukas Märdian](https://canonical.com/blog/author/slyon "More about Lukas Märdian") 5 April 2024 # Introducing Netplan v1.0 – stable, declarative network management [Netplan](https://canonical.com/blog/tag/netplan) [networking](https://canonical.com/blog/tag/networking) [Ubuntu Desktop](https://canonical.com/blog/tag/ubuntu-desktop) [Ubuntu Server](https://canonical.com/blog/tag/ubuntu-server) --- Share the article New “netplan status –diff” subcommand, finding differences between configuration and system state As the maintainer and lead developer of Netplan, I’m proud to announce the general availability of Netplan v1.0 after [more than 7 years](https://ubuntu.com/blog/a-declarative-approach-to-linux-networking-with-netplan) of development efforts. Over the years, we’ve had approximately 80 individual contributors from around the globe. This includes many contributions from our Netplan core-team at Canonical as well as organisations like Microsoft and Deutsche Telekom. Those contributions, alongside the many we receive from our [community of individual contributors](https://github.com/canonical/netplan/pulls?q=is%3Apr+label%3Acommunity), solidify Netplan as an active and trusted open source project. To make Netplan even more dependable, we have also started shipping upstream patch releases, such as 0.106.1 and 0.107.1, which make it easier to integrate fixes into our users’ custom workflows. With the release of version 1.0 the team have focused on stability. Being a major version upgrade, it allowed us to drop some long-standing legacy code from the **libnetplan1** library. Removing this technical debt increases the maintainability of Netplan’s codebase going forward. The upcoming Ubuntu 24.04 LTS and Debian 13 releases will ship Netplan v1.0 to millions of users worldwide. ## Netplan 1.0 highlights In addition to stability and maintainability improvements, it’s worth looking at some of the new features that were also included in the latest release: * Simultaneous WPA2 & WPA3 support. * Introduction of a stable libnetplan1 API. * Mellanox VF-LAG support for high performance SR-IOV networking. * New **hairpin** and **port-mac-learning** settings, useful for VXLAN tunnels with FRRouting. * New **netplan status –diff** subcommand, finding differences between configuration and system state. I’d also like to shed some light on new functionality that was integrated within the past two years for those upgrading from the previous Ubuntu 22.04 LTS which used Netplan v0.104: * We added support for the management of new network interface types, such as **veth**, **dummy**, **VXLAN**, **VRF** or **InfiniBand** (IPoIB). * Wireless functionality was improved by [integrating Netplan with NetworkManager](https://ubuntu.com/blog/netplan-configuration-across-desktop-server-cloud-and-iot) on desktop systems, adding support for WPA3 and adding the notion of a **regulatory-domain**, to choose proper frequencies for specific regions. * To improve maintainability, we moved to Meson as Netplan’s buildsystem, added upstream CI coverage for multiple Linux distributions and integrations (such as Debian testing, NetworkManager, snapd or cloud-init), checks for ABI compatibility, and automatic memory leak detection. * We increased consistency between the supported backend renderers (systemd-networkd and NetworkManager), by [matching physical network interfaces on permanent MAC address](https://discourse.ubuntu.com/t/netplan-0-106-call-for-testing/33932) when the **match.macaddress** setting is being used, and added new hardware offloading functionality for high performance networking, such as Single-Root IO Virtualisation virtual function link-aggregation (SR-IOV VF-LAG). The much improved [Netplan documentation](https://netplan.readthedocs.io), that is now hosted on “Read the Docs”, and new command line subcommands, such as **netplan status**, make Netplan an accessible tool for declarative network management and troubleshooting. ## Further integrations Those changes pave the way to integrate Netplan into 3rd party projects, such as system installers or cloud deployment methods. By shipping the new **python3-netplan** Python bindings to libnetplan, it is now easier than ever to access Netplan functionality and network validation from other projects. We are proud that the [Debian Cloud Team chose Netplan](https://blog.slyon.de/2023/07/10/netplan-and-systemd-networkd-on-debian-bookworm/) to be the default network management tool in their official cloud-images for Debian Bookworm and beyond. Ubuntu’s NetworkManager package now uses [Netplan as it’s default backend on Ubuntu 23.10 Desktop](https://ubuntu.com/blog/netplan-configuration-across-desktop-server-cloud-and-iot) systems and beyond. Further integrations happened with [cloud-init](https://github.com/canonical/cloud-init/pull/4981) and the [Calamares installer](https://github.com/calamares/calamares/pull/2284). ## Learn More Please check out the [Netplan version 1.0 release](https://github.com/canonical/netplan/releases/1.0) on GitHub! If you want to learn more, follow our activities on [Netplan.io](https://netplan.io/), [GitHub](https://github.com/canonical/netplan), [Launchpad](https://bugs.launchpad.net/netplan), [IRC](https://web.libera.chat/gamja/?channels=%23netplan) or our [Netplan Developer Diaries](https://discourse.ubuntu.com/t/blog-netplan-developer-diaries/35932) blog on discourse. ## Sign up for our newsletter Get the latest Canonical news and updates in your inbox. Work email: \*I agree to receive information about Canonical's products and services. By submitting this form, I confirm that I have read and agree to [Canonical's Privacy Policy](https://canonical.com/legal/dataprivacy). Sign up ## Share on --- ## Related posts [### Canonical releases Ubuntu 26.04 LTS Resolute Raccoon](https://canonical.com/blog/canonical-releases-ubuntu-26-04-lts-resolute-raccoon) The 11th long-term supported release of Ubuntu delivers deep silicon optimization and state-of-the-art security for enterprise workloads. [Canonical](https://canonical.com/blog/author/canonical) 23 April 2026 [### How to manage Ubuntu fleets using on-premises Active Directory and ADSys](https://canonical.com/blog/manage-ubuntu-fleets-active-directory) The “hybrid fleet” is today’s reality: organizations diversify operating systems while Microsoft Active Directory (AD) remains the dominant identity “source of truth.” IT... [Massimiliano Gori](https://canonical.com/blog/author/massigori) 31 March 2026 [### How to Harden Ubuntu SSH: From static keys to cloud identity](https://canonical.com/blog/how-to-harden-ubuntu-ssh-cloud) 30 years after its introduction, Secure Shell (SSH) remains the ubiquitous gateway for administration, making it a primary target for brute force attacks and lateral movement... [Massimiliano Gori](https://canonical.com/blog/author/massigori) 30 March 2026 [### Modern Linux identity management: from local auth to the cloud with Ubuntu](https://canonical.com/blog/modern-linux-identity-management-ubuntu) The modern enterprise operates in a hybrid world where on-premises infrastructure coexists with cloud services, and security threats evolve daily. IT administrators are tasked... [Massimiliano Gori](https://canonical.com/blog/author/massigori) 27 March 2026