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.

Have more questions? Submit a request


  • 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!

Powered by Zendesk