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.

How to Uninstall Cumulus Linux and Remove the Configuration



I need to revert installation of Cumulus Linux and all configuration, how do I do it?


  • Cumulus Linux, all versions


To remove the Cumulus Linux operating system and its configuration, follow the step appropriate to the version of Cumulus Linux you are running.

Warning! Running any of the following commands also removes the license file, so Cumulus Networks recommends you back up the license file before proceeding, so you can restore it after you reinstall Cumulus Linux. 

  • onie-select -k
  • cl-img-select -k
  • cl-img-select -u

Cumulus Linux 3.3.0 or Later

If you're running Cumulus Linux 3.3.1, for example, run:

cumulus@switch:~$ onie-select -k

Note: If you only want to remove the Cumulus Linux configuration, and keep the license intact, use the net del all NCLU command instead. This disables routing and the routing daemons, except for Zebra, which is used for static routes and is needed for the other routing daemons.

cumulus@switch:~$ net del all

The following configurations remain, as follows:

  • The IP address for eth0.
  • Default values for any 802.1X configuration.
  • The 4 default NTP servers. However, any other NTP configurations are removed when you run net del all.
  • The time zone reverts to the default, (Etc/UTC).
  • The DNS configuration is not removed; however, if you remove the DNS configuration manually, net del all does not put it back.

Cumulus Linux 3.2.0 or 3.2.1

If you're running Cumulus Linux 3.2.0 or 3.2.1, run:

cumulus@switch:~$ onie-select -k

Cumulus Linux 2.5.3 through 3.1.1

If you're running Cumulus Linux 2.5.4, for example, run:

cumulus@switch:~$ sudo cl-img-select -k
WARNING: Operating System uninstall requested.
WARNING: This will wipe out all system data.
Are you sure (y/N)? y
Enabling uninstall at next reboot...done.
Reboot required to take effect.

This command reverts the switch to ONIE in installer mode.


  • Avatar
    Akiyoshi Tomita

    Cumulus Linux 2.5.3 or later , change cl-img-select command option to "-k"
    $ sudo cl-img-select -k

  • Avatar
    Peter Bratach

    Good catch, Akiyoshi. I just updated the article, so thank you!

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