This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

A Beginner's Guide to Getting Started with Cumulus Linux



This simple document provides a checklist for users like network administrators, who may be new to Linux in general, or Cumulus Linux specifically. Refer to this list when you power on your Cumulus Linux switch for the first time. It links to Cumulus Linux technical documentation, other Help Center articles, and to external sites, and covers topics like configuration, comparing Cumulus Linux to other vendors' CLI, and validated design guides.


Adding and Managing User Accounts

  1. Learn about user accounts
  2. Add a user account (Note: it is in the section before Loopback Interface)
  3. Using sudo to delegate privileges
  4. Cumulus Linux Password
  5. Optional: Configure LDAP for Centralized User Management

Editing Files in Linux

Learn how to use the nano text editor (cheat sheet — external link)

Customizing the Switch

  1. Initial configuration
  2. Configure external system logging

ACL/IP Rules

  1. Allow SSH from specific subnets only
  2. Cumulus Linux ACL example rules

Networking with Cumulus Linux 

  1. Configuring and managing network interfaces
  2. VLAN-aware bridge mode for large-scale layer 2 environments
  3. Configuring switch port attributes
  4. Network troubleshooting

Monitoring the Switch

Installers and Upgrades (Cumulus Linux and Packages)

  1. Adding and updating packages
  2. Upgrading Cumulus Linux
  3. What files should I back up when updating Cumulus Linux via image install?

Suggested Further Reading

More Networking On Cumulus Linux

  1. Manually putting all switch ports into a single VLAN
  2. Reserved MAC address range for use with Cumulus Linux
  3. Network topology
  4. Link Layer Discovery Protocol LLDP
  5. Bonding - Link Aggregation
  6. MLAG
  7. Routing
  8. Configuring FRRouting

General Useful Links

Cumulus Networks Validated Design Guides



This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk