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

# Troubleshooting

export const TroubleshootSolution = ({children}) => <>
    <hr className="my-3 w-full" />
    <details className="mt-3">
      <summary className="cursor-pointer font-semibold text-base mb-1">
        Solution
      </summary>
      <div className="mt-2 ml-4" data-component-part="step-content">
        {children}
      </div>
    </details>
  </>;

export const TroubleshootCause = ({children}) => <details className="mt-3 mb-2">
    <summary className="cursor-pointer font-semibold text-base mb-1">
      Cause
    </summary>
    <div className="mt-2 ml-4" data-component-part="step-content">
      {children}
    </div>
  </details>;

export const TroubleshootTitle = ({children}) => <>
    <p className="m-0 font-semibold text-xl leading-tight mb-2" role="heading" aria-level={3}>
      {children}
    </p>
    <hr className="my-3 w-full" />
  </>;

export const Troubleshoot = ({children}) => <div className="callout my-4 px-5 py-4 overflow-hidden rounded-2xl flex gap-3 border troubleshoot-admonition dark:troubleshoot-admonition" data-callout-type="troubleshoot">
    <div className="mt-0.5 w-4">
      <svg width="14" height="14" viewBox="0 0 640 640" fill="currentColor" className="w-4 h-4" aria-label="Troubleshoot">
        <path d="M541.4 162.6C549 155 561.7 156.9 565.5 166.9C572.3 184.6 576 203.9 576 224C576 312.4 504.4 384 416 384C398.5 384 381.6 381.2 365.8 376L178.9 562.9C150.8 591 105.2 591 77.1 562.9C49 534.8 49 489.2 77.1 461.1L264 274.2C258.8 258.4 256 241.6 256 224C256 135.6 327.6 64 416 64C436.1 64 455.4 67.7 473.1 74.5C483.1 78.3 484.9 91 477.4 98.6L388.7 187.3C385.7 190.3 384 194.4 384 198.6L384 240C384 248.8 391.2 256 400 256L441.4 256C445.6 256 449.7 254.3 452.7 251.3L541.4 162.6z" />
      </svg>
    </div>
    <div className="prose min-w-0 w-full">{children}</div>
  </div>;

Common issues and solutions for the Anaconda CLI. If you encounter an issue that does not have a solution here, or if you have a feature request, [submit feedback](/cli-reference/anaconda-cli/self-update#submit-feedback) directly from the CLI.

<Troubleshoot>
  <TroubleshootTitle>
    ### `ana: command not found` after installation
  </TroubleshootTitle>

  <TroubleshootCause>
    The installation directory is not in your shell's PATH, or your shell session hasn't picked up the updated profile yet.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Open a new terminal window or tab.
    2. If the command is still not found, verify the binary exists at the install location (default: `~/.local/bin/ana` on macOS/Linux, `~\.local\bin\ana.exe` on Windows).
    3. Add the install directory to your PATH manually if needed. On macOS/Linux:

       ```bash theme={null}
       export PATH="$HOME/.local/bin:$PATH"
       ```

       Add this line to your shell profile (`~/.bashrc`, `~/.zshrc`, or equivalent) to make it permanent.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Keyring error when running `ana whoami` or `ana login`
  </TroubleshootTitle>

  <TroubleshootCause>
    The keyring file is corrupted or contains credentials in an unexpected format.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Log out to clear the stored credentials:

       ```bash theme={null}
       ana logout
       ```

    2. Log in again:

       ```bash theme={null}
       ana login
       ```

    If `ana logout` also fails with a keyring error, delete the keyring file manually and then log in again:

    <Tabs>
      <Tab title="Windows">
        ```powershell theme={null}
        Remove-Item "$env:USERPROFILE\.anaconda\keyring"
        ```
      </Tab>

      <Tab title="macOS/Linux">
        ```bash theme={null}
        rm ~/.anaconda/keyring
        ```
      </Tab>
    </Tabs>
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### `ana self update` fails or cannot reach the download server
  </TroubleshootTitle>

  <TroubleshootCause>
    A firewall, proxy, or network policy is blocking outbound HTTPS requests to the download server.
  </TroubleshootCause>

  <TroubleshootSolution>
    1. Verify you can reach the server:

       ```bash theme={null}
       curl -I https://anaconda.sh
       ```

    2. If you are behind a corporate proxy, ensure your `HTTPS_PROXY` environment variable is set correctly.

    3. If the issue persists, download the binary directly from the [releases page](https://anaconda.sh/downloads/) and replace the existing binary at your install location.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### Permission denied when writing to the keyring or install directory
  </TroubleshootTitle>

  <TroubleshootCause>
    The `~/.anaconda/` directory or the install directory has incorrect file permissions, often caused by running a previous installation with elevated privileges.
  </TroubleshootCause>

  <TroubleshootSolution>
    Reset ownership of the relevant directory. On macOS/Linux:

    ```bash theme={null}
    sudo chown -R $(whoami) ~/.anaconda
    ```

    For install directory permission issues:

    ```bash theme={null}
    sudo chown -R $(whoami) ~/.local/bin
    ```
  </TroubleshootSolution>
</Troubleshoot>