All packages that are included in the official Cumulus Linux distribution are available from Cumulus Networks repository servers. Depending upon the version of Cumulus Linux you are running, the repository is organized differently.
Cumulus Linux Repos for Versions 3.0.0 and Later
Cumulus Linux 3.0.0 and later distributions are organized into the following package sources:
|Short Name||Contents||Codename||Cumulus Linux Update Version*|
|mainline||All packages in the Cumulus Linux image.
Optional additional packages.
New features and hardware platforms.
All previous security and maintenance updates.
|CumulusLinux-3||Minor update (3.Y)|
|security||Security-related updates to any packages in mainline.||CumulusLinux-3-security-updates||Maintenance update (3.Y.Z)|
|updates||Bug fixes and updates to any packages in mainline that are not security related.||CumulusLinux-3-updates||Maintenance update (3.Y.Z)|
|early access||Packages that are still undergoing development and should not be used in a production environment.||CumulusLinux-3-early-access||Packages updated asynchronously from updates.|
Optional third party packages, (for example, Puppet from Puppet Labs).
Not affiliated with or related to the Cumulus Networks Solutions Marketplace.
* For more information on Cumulus Linux versioning, please refer to the Cumulus Linux Release Versioning and Support Policy.
** In development. Does not contain packages as of the Cumulus Linux 3.0 initial release.
The mainline, security and updates sources are enabled by default. In addition to packages in the Cumulus Linux image, the default configuration provides access to additional packages such as
git, as well as Cumulus-provided updates for all these packages.
To maintain access to the latest Cumulus Linux updates, keep the updates source enabled.
If you're an early adopter or are testing out new features that are not yet in Cumulus Linux mainline, you can enable the early-access source.
You can enable non-default sources by uncommenting the corresponding lines in
cumulus@switch:~$ cat /etc/apt/sources.list deb http://repo3.cumulusnetworks.com/repo CumulusLinux-3 cumulus upstream deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3 cumulus upstream deb http://repo3.cumulusnetworks.com/repo CumulusLinux-3-security-updates cumulus upstream deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-security-updates cumulus upstream deb http://repo3.cumulusnetworks.com/repo CumulusLinux-3-updates cumulus upstream deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-updates cumulus upstream #deb http://repo3.cumulusnetworks.com/repo CumulusLinux-3-early-access cumulus #deb-src http://repo3.cumulusnetworks.com/repo CumulusLinux-3-early-access cumulus # Currently under construction #deb http://community.cumulusnetworks.com/repo CumulusLinux-3-marketplace commercial community
The contents of each repository component in
sources.list can be described as follows:
- cumulus: Contains packages maintained by Cumulus Networks.
- upstream: Contains unmodified packages from an upstream community.
- commercial: Contains packages from third party vendors.
- community: Contains community-contributed packages.
Cumulus Linux Repos for Versions 1.5.z and 2.y.z
Cumulus Linux distributions for versions 1.5.z and 2.y.z are organized into the following components:
- main: This contains all the packages that are in the Cumulus Linux image, including packages from Debian and other sources.
- addons: This contains additional packages that are not in the image (for example, Puppet from Puppet Labs).
- updates: This contains updates to any of the packages in main that are not security related.
- security-updates: This contains updates to any of the packages in main that are security related.
- testing: This contains packages that are still undergoing development.
You can select which repositories you want to draw from using apt by uncommenting the appropriate repos in
cumulus@switch:~$ cat /etc/apt/sources.list # The Cumulus Package Repository. # # Only packages from this repository are supported # # deb http://repo.cumulusnetworks.com CumulusLinux-2.5 main addons updates deb http://repo.cumulusnetworks.com CumulusLinux-2.5 security-updates # Uncomment the next line to get access to the testing component # deb http://repo.cumulusnetworks.com CumulusLinux-2.5 testing # Uncomment the next line to get access to the Cumulus community repository # deb http://repo.cumulusnetworks.com/community/ CumulusLinux-Community-2.5 main addons updates
Accessing the Repository
To access packages from the repository server, you simply follow Debian convention and use
apt-get. You can find details in the Cumulus Linux user guide.