This documentation is for an older version of the software. If you are using the current version of Cumulus Linux, this content may not be up to date. The current version of the documentation is available here. If you are redirected to the main page of the user guide, then this page may have been renamed; please search for it there.

Cumulus Linux User Guide

Introducing Cumulus Linux

Cumulus Linux is the networking industry’s first full-featured Linux operating system. The Debian Jessie-based, networking-focused distribution runs on hardware produced by a broad partner ecosystem, ensuring unmatched customer choice regarding silicon, optics, cables, and systems.

This user guide provides in-depth documentation covering installing Cumulus Linux, system configuration and management, network solutions, and monitoring and troubleshooting recommendations. In addition, the quick start guide provides an end-to-end setup process to get you started with Cumulus Linux.

This documentation is current as of June 27, 2017 for version 3.3.2. Please visit the Cumulus Networks Web site for the most up to date documentation.

Read the release notes for new features and known issues in this release.

What’s New in Cumulus Linux 3.3.2

Cumulus Linux 3.3.2 bug fixes only, as well as these early access features:

  • QinQ, for hybrid cloud connectivity

  • VXLAN routing, for IP routing between VXLAN VNIs in an overlay network

For further information regarding bug fixes and known issues present in this release, refer to the product release notes.

Open Source Contributions

Cumulus Networks has forked various software projects, like CFEngine, Netdev and some Puppet Labs packages in order to implement various Cumulus Linux features. The forked code resides in the Cumulus Networks GitHub repository.

Cumulus Networks developed and released as open source some new applications as well.

The list of open source projects is on the open source software page.

Hardware Compatibility List

You can find the most up to date hardware compatibility list (HCL) here. Use the HCL to confirm that your switch model is supported by Cumulus Networks. The HCL is updated regularly, listing products by port configuration, manufacturer, and SKU part number.