Release Notes
Release 25.06 (2025-06-11)
Discard static routes
Redistribution of static routes into OSPF, IS-IS, RIPv2, RIPng, and BGP
LAG on Junos
Release 2.0.1 (2025-05-23)
Release 2.0.1 includes bug and documentation fixes as well as minor device configuration improvements.
Release 2.0.0 (2025-05-10)
Well-defined node roles (host, router, bridge) available on multiple platforms
firewall.zonebased plugin
bridge nodes can be used as simple bridges or to implement multi-access links
netlab defaults command provides sysctl-like CLI interface to user/system defaults.
SRv6: BGP L3VPN support
VirtualBox and direct Windows/macOS installations are obsolete
Release 1.9.6 (2025-03-21)
Add ‘gateway’ as a valid next-hop for static routes
Rewrite the default gateway processing and add IPv6 default gateways
Set libvirt MTU to 9500 on bridge-based networks
Release 1.9.5 (2025-03-05)
Cumulus Linux NVUE: VXLAN, EVPN, VRF-aware BGP, VRF route leaking, route import
Junos: BGP local-as, allowas-in, and EBGP multihop
vJunos-switch: anycast gateway, VXLAN, and EVPN
Use configured node management MAC/IPv4 addresses in vagrant-libvirt DHCP pool
Make
--instance
and--snapshot
CLI parameters consistent
Release 1.9.4-post2 (2025-02-10)
This release fixes niche features in multiple configuration templates and a few bugs.
Release 1.9.4-post1 (2025-02-03)
This release fixes a convoluted bug triggered by Arista EOS internal VLAN allocation and a few quirks in the configuration templates.
Release 1.9.4 (2025-01-29)
Release 1.9.4 includes numerous bug fixes and fixes in device definitions and configuration templates.
Release 1.9.3-post1 (2025-01-15)
This release fixes a few things we broke in 1.9.3 and pins the version of python-box
.
Release 1.9.3 (2025-01-09)
Multi-chassis Link Aggregation (MLAG) support in the Link Aggregation Group (LAG) Configuration Module for IEEE 802.3ad
Global, VRF, and inter-VRF static routes with direct or indirect next hops.
Node cloning plugin simplifies repetitive topologies by cloning nodes
Consistent selection of prefix pools based on the number of nodes attached to a link (⚠️ breaking change)
Release 1.9.2-post1 (2024-12-10)
This release fixes an annoying bug affecting users of Ansible 11.x.
Release 1.9.2 (2024-11-03)
Link Aggregation Group (LAG) Configuration Module for IEEE 802.3ad
The netlab exec command can execute the same command on a set of network devices
netlab supports Cisco IOS on Linux (IOL), IOL layer-2 image, and IOSv/IOSvL2 in vrnetlab containers
Edgeshark can be used as an external tool to provide GUI-based access to lab packet capture
Release 1.9.1 (2024-10-05)
netlab capture command implements packet capture on VM- or container interfaces
IS-IS route import (redistribution) and IS-IS VRF instances
RIPv2/Ripng route import and VRF instances
Support for Cisco IOSv layer-2 image
Release 1.9.0-post1 (2024-08-26)
This release contains minor improvements, numerous SR Linux configuration fixes, a few other bug fixes, and documentation fixes.
Release 1.9.0 (2024-08-19)
Generic Routing Configuration Module supporting routing policies, prefix filters, AS-path filters, and BGP community filters
Default route origination in OSPFv2 and OSPFv3
Route import (redistribution) into OSPFv2, OSPFv3, and BGP.
Change device configuration or use SuzieQ in validation tests
Release 1.8.4-post2 (2024-07-13)
This release contains only bug fixes and documentation fixes.
Release 1.8.4-post1 (2024-07-01)
This release contains only bug fixes and documentation fixes.
Release 1.8.4 (2024-06-22)
Support for Cisco Catalyst 8000v
Unified support of vrnetlab containers (including ArubaCX, Cisco Catalyst 8000v, Cisco CSR 1000v, Dell OS10, Cisco Nexus 9000v, Mikrotik RouterOS, Juniper vMX, vPTX and vSRX)
Automated build of GitHub Codespaces devcontainer
Handle keyboard interrupts in long-running netlab commands, including netlab up, netlab initial and netlab validate.
Add
--ready
action to netlab initial command to wait for lab devices to become ready without configuring them.
Release 1.8.3 (2024-06-16)
BGP Link Bandwidth community in bgp.policy plugin
BGP route server/client in bgp.session plugin.
Installation scripts work with Ubuntu 24.04. They were also tested on Ubuntu 22.04, Ubuntu 20.04, and Debian Bookworm.
Release 1.8.2 (2024-05-13)
Create reports from a subset of nodes
Inspect the same variable(s) across multiple nodes
Check for the presence of Vagrant boxes or Docker containers before starting the lab and display pointers to build recipes.
Check installed Ansible collections before starting netlab up or netlab initial
Support for Sonic VM based on Azure sonic-vs images.
Numerous improvements in the Vagrant box-building process
Release 1.8.1-post1 (2024-04-24)
This release contains only bug fixes and documentation fixes.
Release 1.8.1 (2024-04-08)
Refactor the netlab status printout
Add ‘retry tests until the timeout’ functionality to netlab validate (including the actual time it took to get the expected results).
OSPFv3 in VRFs, implemented on Arista EOS, Cisco IOS, Cisco IOS-XE, FRR, and Junos (vMX, vPTX, vSRX).
EBGP sessions over IPv4 unnumbered and IPv6 LLA interfaces on Arista EOS
Cisco IOS XRd container support
Numerous configuration template fixes, including reduced OSPF SPF/LSA and IPv6 ND RA timers.
Release 1.8.0 (2024-03-01)
netlab up command can reload saved device configurations instead of starting the initial device configuration process.
DHCP configuration module implements DHCP clients, DHCP servers, and DHCP relays for IPv4 and IPv6.
Lab topology can include control plane- and network services daemons running in Linux containers. This release includes BIRD and dnsmasq daemons.
BGP configuration module supports 4-octet BGP AS numbers and large BGP communities.
Validation plugins allow you to write more powerful netlab validate validation tests without creating complex Jinja2 templates
You can build Docker containers for the supported daemons with the netlab clab build command
Release 1.7.2 (2024-01-26)
This release contains only bug fixes and documentation fixes.
Release 1.7.1 (2024-01-08)
Add ‘wait’ parameter to validation tests
Use colors in netlab up/down/test/validate printouts
Use color-coded error messages
Use the rich Python library to pretty-print tables, JSON, and YAML
Release 1.7.0 (2023-12-03)
netlab validate command can be used to execute lab validation tests.
The fabric plugin generates a whole leaf-and-spine fabric topology from a few parameters.
The bgp.domain plugin allows you to create topologies with multiple independent devices or sites using the same BGP AS number.
The bgp.policy plugin supports AS-path prepending on Arista EOS, Aruba AOS-CX, Cisco CSR 1000v, Cisco IOSv, Cumulus Linux, FRR
bgp.originate plugin uses loopbacks (instead of static routes to Null device) to originate BGP IPv4 and IPv6 prefixes
The
--show
option of the netlab connect command implements a consistent cross-device way of executing show commands.
For older releases, check the release notes archive.
Individual release notes
- Changes in Release 25.06
- Changes in Release 2.0
- Changes in Release 1.9
- Changes in Release 1.8
- Changes in Release 1.7
- Release Notes Archive
- Changes in Release 1.6
- Changes in Release 1.5
- Changes in Release 1.4
- Changes in Release 1.3
- Changes in Release 1.2
- Changes in Release 1.1
- Changes in Release 1.0.x
- Changes in Release 0.9 through 0.9.3
- Changes in Release 0.8 and 0.8.1
- Changes in Release 0.7
- Changes in Release 0.6
- Changes in Release 0.5
- Changes in Release 0.4
- Changes in Release 0.3