You're reading the development documentation. Release version of the same page is here.

Release notes

Release 1.5.4 (2023-06-10)

  • Juniper vPTX/vEVO support by Stefano Sasso (initial configuration, IPv4+IPv6, OSPFv2/v3, IS-IS, BGP, BFD, VLANs, VRFs, MPLS, SR-MPLS)

  • Juniper vSRX can be run as a vrnetlab-packaged container (by Stefano Sasso)

  • Documentation migrated to netlab.tools

Release 1.5.3 (2023-05-15)

  • ‘unknown’ device type can be used to deploy devices not yet supported by netlab

  • Public libvirt networks can be used to connect labs to outside world

  • MPLS VPN support for SR OS

  • Improved virtualization provider installation testing with (hopefully) useful error messages

Release 1.5.2 (2023-04-27)

Release 1.5.1 (2023-04-02)

Release 1.5.0 (2023-01-28)

Release 1.4.3 (2023-01-12)

Release 1.4.2 (2022-12-18)

  • Juniper vMX support

  • Junos BFD, VRF, MPLS, SR-MPLS, and MPLS/VPN support

  • Full VLAN support on vMX and routed VLAN interfaces on vSRX

  • CSR 1000v VLAN and VXLAN support

  • VyOS containerlab support

Release 1.4.1 (2022-11-25)

  • Cisco ASAv support

  • VRRP and anycast gateway on Dell OS10

  • VRRP on VyOS

  • Unnumbered OSPF interfaces on VyOS

  • Add support for all EVPN bundle services

Release 1.4.0 (2022-11-04)

  • EVPN asymmetric IRB

  • Anycast gateway and VRRP

  • EVPN MPLS transport

  • New address allocation algorithm for links with small IPv4 prefixes

  • Tighter control of VXLAN-enabled and EVPN-controlled VLANs and VRFs

  • Unmanaged and unprovisioned devices

Release 1.3.2 (2022-10-01)

  • Mikrotik RouterOS version 7 support by Stefano Sasso, including IPv4, IPv6, VLANs, VRFs, OSPFv2, OSPFv3, BGP, MPLS, MPLS/VPN

  • Nokia SR OS support for VLAN, VXLAN, EVPN, VRF, and OSPFv3 by Jeroen van Bemmel

  • OSPFv3 on Cumulus Linux and Nexus OS

  • EVPN (bridging and symmetric IRB) on Nexus OS

  • EVPN VLAN bundle service on SR Linux

  • EVPN transit VNI shared between VRFs

  • Define VLAN and VRF parameters in groups

Release 1.3.1 (2022-09-17)

  • VXLAN, VLANs, VRFs, and EVPN implemented on FRR and Cumulus Linux

  • BGP local-as implemented in the BGP configuration module and supported on Arista EOS, Cisco IOS, Dell OS10, FRR, and Nokia SR Linux.

  • Configurable BGP transport sessions

  • Configurable default BGP address families supported on Arista EOS, Cisco IOS, Cumulus Linux, FRR, and Nokia SR Linux.

  • Select address pools with ‘pool’ VLAN or link attribute (using ‘role’ attribute to select an addressing pool is deprecated)

  • FRR support for IPv6 LLA (unnumbered) BGP sessions

  • New default VM versions: FRR 8.3.1 and Cumulus Linux 4.4.0 (container), Cumulus Linux (NVUE) 5.2.0 (VM)

  • Per-VRF BGP router ID on Cisco IOS and Arista EOS

Release 1.3 (2022-08-27)

  • ‘netsim-tools’ package renamed to ‘networklab’

  • VXLAN configuration module

  • EVPN configuration module

  • 6PE added to MPLS configuration module

  • IS-IS on VyOS

  • VLANs and VRFs on Cisco Nexus OS

  • VRFs on Nokia SR Linux

  • Default route origination on EBGP sessions

Release 1.2.4 (2022-06-20)

  • VLAN support for Mikrotik RouterOS and VyOS

  • Routed VLANs and routed VLAN subinterfaces

  • ebgp_utils plugin

  • User-modifiable templates used in Vagrantfile creation

  • Bug fixes and documentation fixes

Release 1.2.3 (2022-05-26)

  • VLAN support for SR Linux

  • Bug fixes

Release 1.2.2 (2022-05-02)

  • VLAN configuration module

  • External topology provider to use netlab with hardware labs

  • VRF loopback interfaces

  • netlab restart command restarts or reconfigures the lab

  • Use the snapshot file to start a lab

  • Specify NIC model used by libvirt virtualization provider

  • Set device type or configuration modules in groups

  • Persistent Linux network provisioning

  • Debian supported by the installation scripts

Release 1.2.1 (2022-04-16)

  • Graphite GUI

  • Dell OS10 on libvirt

  • VRFs, MPLS, and MPLS/VPN on Mikrotik RouterOS and VyOS

  • Containerlab support for Cumulus NVUE

  • VRF Lite on Cumulus NVUE

Release 1.2.0 (2022-04-01)

  • VRF definitions and layer-3 VRFs

  • VRF-aware OSPF, IS-IS and BGP

  • Traditional MPLS with LDP

  • BGP Labeled Unicast

  • MPLS/VPN: VPNv4 and VPNv6 address family support

  • OSPFv3 support on Juniper vSRX

  • Use topology snapshot file in netlab down

Release 1.1.4 (2022-03-09)

  • netlab clab tarball create a tar package that can be deployed with containerlab without netlab

  • Added tar and cleanup options to netlab collect

  • Added cleanup option to netlab down

  • Support for OSPFv3 on VyOS

  • Build recipes for Arista vEOS and Juniper vSRX use management VRF

  • Use netlab_device_type instead of ansible_network_os to select configuration templates

  • Developer documentation for initial device configurations, OSPFv2 and OSPFv3

  • Add fetch_config action for SR Linux and SR OS. You can use netlab collect to get current configuration from these devices

Release 1.1.3 (2022-02-14)

  • Restructured installation documentation

  • OSPFv3 support

  • netlab show command displays system settings in tabular format

  • EIGRP implementation of common routing protocol features

  • Configurable address family support (IPv4 and/or IPv6) for IS-IS, OSPF, and EIGRP

  • Libvirt box creating script for Cisco CSR 1000v and Juniper vSRX 3.0

  • Support for /31 IPv4 P2P links

  • Configurable MTU for VyOS and RouterOS

Release 1.1.2 (2022-01-29)

  • Containerlab installation script

  • System and interface MTU

  • Configurable VM memory and CPU settings

  • Configurable BGP cluster ID

  • Router ID calculations for IPv6-only devices and configurable router ID

  • Hosts and default gateways

  • Static loopback addresses

  • Cumulus Linux 5.0 support (configuration via NVUE)

  • BGP graphs can show RR-client sessions as directed arrows

  • Building vEOS and Nexus 9300v libvirt boxes has been significantly simplified with netlab libvirt package command

  • Proof-of-concept EVPN and SRv6 modules

Release 1.1.1 (2022-01-20)

  • Cumulus VX: unnumbered interfaces and support for EBGP sessions over unnumbered IPv4 interfaces

  • OVS bridge support in containerlab provider

  • Bug fixes

Release 1.1 (2022-01-09)

  • New IPAM functionality: layer-2-only links and interfaces, per-protocol unnumbered interfaces

  • IPAM code refactoring

  • BFD configuration module

  • BFD with IS-IS and OSPF

  • Device capability checks: unnumbered interfaces, OSPF and IS-IS over unnumbered links

  • Linux bridges are used to implement multi-access links in containerlab

  • Simplified IS-IS and OSPF configuration templates

  • Reorganized nodes list into a dictionary

  • Reorganized link interfaces into a list

Release 1.0.6 (2021-12-28)

  • Full SR Linux and SR OS support

  • Plugin packages and module extensions

  • Hierarchical device groups

  • Custom deployment templates moved to ‘netlab initial’

  • Device-specific module attributes

  • Support for multi-access links in containerlab

Release 1.0.5 (2021-12-19)

  • Custom deployment templates for individual nodes

  • Support for vagrant-libvirt 0.7.0

  • Support for more than 10 lab devices under libvirt

  • Extendable topology-, link- and module parameters

  • Automatic creation of vagrant-libvirt management network

  • Bug fixes

Release 1.0.4 (2021-12-11)

  • Fortinet configuration (IPv4, IPv6, OSPF)

  • Links without IP addressing

  • IOSv, CSR, vSRX on VirtualBox

  • Bug fixes

Release 1.0.3 (2021-12-06)

  • Initial support for Fortinet devices

  • Skip devices that cannot be configured during lab initialization process

  • Bug fixes

Release 1.0.2 (2021-11-27)

  • Support for Mikrotik CHS and Vyos devices (contributed by Stefano Sasso)

  • Group-specific node data

  • Automatic creation of AS-based groups

  • Custom plugins

Release 1.0.1 (2021-11-20)

  • Custom inventory groups

  • Group-specific custom configuration templates

  • Composite command debugging

  • Quiet run of Ansible playbooks

Release 1.0 (2021-10-25)

  • netlab up enables LLDP passthrough on Linux bridges created with libvirt Vagrant plugin

  • Cleanup: remove the old CLI commands and related documentation

Release 0.9.3 (2021-10-13)

  • Add netlab up and netlab down commands

  • Add static node IDs and interface addresses

Release 0.9.2 (2021-10-08)

  • Add a simple YAML-based inventory file to replace ansible_inventory if you happen to hate Ansible.

Release 0.9.1 (2021-09-19)

  • Hosts in network labs (Linux VMs or containers)

Release 0.9 (2021-08-20)

  • Topology graphs (physical topology and BGP sessions)

  • YAML or JSON representation of transformed network topology

  • Generic output framework

Release 0.8 (2021-07-09)

  • Python package

  • Unified CLI

  • Support for Cumulus VX and Nokia SR Linux containers

  • Installation and testing scripts

Release 0.7 (2021-05-31)

  • EIGRP configuration module

  • BGP parameters: advertise_loopback, originate prefixes, community propagation

  • BGP IPv6 address family configuration

  • OSPF reference bandwidth

  • IS-IS P2P network type on all P2P links (not just unnumbered)

  • Single-module initial configuration

  • Python type hinting and mypy checks

Release 0.6.3 (2021-05-24)

  • BGP configuration module

  • IS-IS configuration module

  • Segment Routing with MPLS

  • OSPF configuration improvements: external links and passive interfaces

  • FRR and Cumulus VX support

  • Installation playbook

  • Bug fixes

Release 0.5 (2021-04-11)

  • containerlab support

  • Flexible virtualization provider framework

Release 0.4 (2021-03-26)

  • Unnumbered interfaces

  • Configuration modules framework

  • Baseline OSPF module

Release 0.3 (2021-01-24)

  • Support for multiple virtualization providers

  • Vagrant with VirtualBox

  • EOS and Nexus OS supported on Vagrant/VirtualBox

  • Device images (Vagrant boxes) are configurable in the defaults

Release 0.2 (2021-01-12)

Major refactoring of addressing configuration

  • Structured address pools (loopback, lan, p2p)

  • IPv4 and IPv6 support

  • Initial configuration modules updated to work in dual-stack or IPv6-only environments

Release 0.11 (2021-01-07)

Arrcus ArcOS support contributed by Dave Thelen

Refactored configuration gathering – use explicit device_facts modules or platform-specific tasks for platforms that don’t gather device configuration with fact-gathering module

2020-12-21

Nexus 9300v support

2020-12-17

Initial release (IOSv, CSR, EOS)

Individual release notes