> ## Documentation Index
> Fetch the complete documentation index at: https://flox.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Uninstall Flox

> How to uninstall the Flox CLI

While we are sad we see you uninstalling `flox` we would like to **thank you**
for giving `flox` a try.

As we try to improve `flox` we really appreciate any feedback, especially
where we failed. We like to know what was not working or where could we do
a better job. Please reach us [via discourse](https://discourse.flox.dev) or
[via email](mailto:hello@flox.dev).

Here's how to **completely remove `flox` from your system**.

<Tabs>
  <Tab title="MacOS (Pkg)">
    <Warning>
      **The following commands will completely remove Nix and the contents of `/nix/*` from the system.**
    </Warning>

    Be sure to back up the system and/or extract any important Nix-related
    files and packages before continuing.

    1. Ensure no running processes are using `/nix`.

    2. Run:

       ```
       sudo /usr/local/share/flox/scripts/uninstall
       ```

    Regardless of the current state, brew can be used to perform a full clean up:

    ```
    brew uninstall --force --zap flox
    ```

    We recommend rebooting your system after uninstalling Flox.
  </Tab>

  <Tab title="MacOS (Homebrew)">
    <Warning>
      **The following commands will completely remove Nix and the contents of `/nix/*` from the system.**
    </Warning>

    Be sure to back up the system and/or extract any important Nix-related
    files and packages before continuing.

    <Note>
      **You may be asked if the terminal has permission to modify contents of the disk.**
    </Note>

    Run:

    ```
    brew uninstall flox
    ```

    To remove all traces of flox including user preferences uninstall with:

    ```
    brew uninstall --zap flox
    ```

    In the case of recovering a partial install, a force and zap can help:

    ```
    brew uninstall --force --zap flox
    ```

    We recommend rebooting your system after uninstalling Flox.
  </Tab>

  <Tab title="Debian">
    For use on Debian, Ubuntu, and other Debian-based distributions.

    <Warning>
      **The following command will completely remove Nix and the contents of `/nix/*` from the system.**
    </Warning>

    Be sure to back up the system and/or extract any important Nix-related
    files and packages before continuing.

    ```
    sudo apt-get purge flox
    ```

    We recommend rebooting your system after uninstalling Flox.
  </Tab>

  <Tab title="RPM">
    For use on RedHat, CentOS, Amazon Linux, and other RPM-based
    distributions.

    <Warning>
      **The following command will completely remove Nix and the contents of `/nix/*` from the system.**
    </Warning>

    Be sure to back up the system and/or extract any important Nix-related
    files and packages before continuing.

    ```
    sudo yum remove flox
    ```

    We recommend rebooting your system after uninstalling Flox.

    <Accordion title="Output on success:">
      ```
      $ sudo yum remove flox
      Updating Subscription Management repositories.
      Unable to read consumer identity

      This system is not registered to Red Hat Subscription Management.
      You can use subscription-manager to register.

      Dependencies resolved.
      ======================================================================
          Package       Architecture    Version              Repository   Size
      ======================================================================
      Removing:
          flox          x86_64          1.4.3-1625910780     @@System     109 M

      Transaction Summary
      ======================================================================
      Remove  1 Package

      Freed space: 109 M
      Is this ok [y/N]: y
      Running transaction check
      Transaction check succeeded.
      Running transaction test
      Transaction test succeeded.
      Running transaction
          Preparing        :                                               1/1
          Running scriptlet: flox-1.4.3-1625910780.x86_64                  1/1
      floxadm uninstall complete

          Erasing          : flox-1.4.3-1625910780.x86_64                  1/1
          Running scriptlet: flox-1.4.3-1625910780.x86_64                  1/1
          Verifying        : flox-1.4.3-1625910780.x86_64                  1/1
      Installed products updated.

      Removed:
          flox-1.4.3-1625910780.x86_64

      Complete!
      ```
    </Accordion>
  </Tab>

  <Tab title="Nix (Generic)">
    If you've installed flox to the system-wide `default` profile

    ```
    sudo -H nix profile remove \
            '.*flox' \
            --profile /nix/var/nix/profiles/default \
            --experimental-features "nix-command flakes"
    ```

    Or, if you've installed flox to your own *personal* profile

    ```
    nix profile remove \
            '.*flox' \
            --experimental-features "nix-command flakes"
    ```

    Or, if you've declared Flox using a flake, remove the Flake
  </Tab>

  <Tab title="WSL">
    Please follow the instructions provided on either the Debian or RPM tab
    (whichever matches the existing Linux Distribution installed with your
    WSL) to uninstall Flox.
  </Tab>
</Tabs>