> ## 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>;

<Troubleshoot>
  <TroubleshootTitle>
    ### `AnacondaLoginRequired`
  </TroubleshootTitle>

  <TroubleshootCause>
    The command requires an authenticated session, but no valid login was detected. `anaconda-repo-cli` relies on `anaconda-auth` for authentication, so this error means the auth plugin has no stored credentials for the configured site.
  </TroubleshootCause>

  <TroubleshootSolution>
    Log in using the `anaconda-auth` CLI:

    ```sh theme={null}
    anaconda login
    ```

    If you have multiple sites configured, specify which one to authenticate against:

    ```sh theme={null}
    anaconda --at <SITE> login
    ```
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### `Unauthorized`
  </TroubleshootTitle>

  <TroubleshootCause>
    The server recognized your credentials but denied permission for the requested operation. This can occur when your user account or token does not have the required role or scope to access the target resource, such as a private channel or an admin-only endpoint.
  </TroubleshootCause>

  <TroubleshootSolution>
    Verify that your token has the required permissions by checking your auth tokens:

    ```sh theme={null}
    anaconda repo auth --list
    ```

    If permissions are insufficient, request access from your organization administrator or create a new token with the appropriate scopes.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### `NotFound`
  </TroubleshootTitle>

  <TroubleshootCause>
    The requested resource does not exist on the server. This typically means the channel name, package name, or artifact identifier in the command does not match any resource on the configured site. It can also occur when targeting the wrong site in a multi-site configuration.
  </TroubleshootCause>

  <TroubleshootSolution>
    Double-check the resource name in your command. You can list available channels to confirm the name:

    ```sh theme={null}
    anaconda repo channel --list
    ```

    If you have multiple sites configured, make sure you are targeting the correct one with the `--site` flag:

    ```sh theme={null}
    anaconda repo channel --list --site <SITE>
    ```
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### `NoDefaultUrl`
  </TroubleshootTitle>

  <TroubleshootCause>
    No repository URL has been configured. `anaconda-repo-cli` needs to know which Anaconda Platform instance to connect to, and no `default_site` or site configuration was found in `~/.anaconda/config.toml`.
  </TroubleshootCause>

  <TroubleshootSolution>
    Add a site configuration using the `anaconda sites add` command:

    ```sh theme={null}
    anaconda sites add https://your-platform-domain.example.com
    ```

    Alternatively, set `default_site` manually in `~/.anaconda/config.toml`. For a full walkthrough, see [Getting started with anaconda-repo-cli](/docs/cli-reference/anaconda-repo-cli/getting-started).
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### `ChannelFrozen`
  </TroubleshootTitle>

  <TroubleshootCause>
    The target channel has been frozen, which prevents any modifications such as uploading, copying, moving, or removing packages. Freezing a channel is an intentional action to protect its contents from changes.
  </TroubleshootCause>

  <TroubleshootSolution>
    If you need to modify the channel, unfreeze it first:

    ```sh theme={null}
    anaconda repo channel --unfreeze <CHANNEL>
    ```

    If the channel was frozen intentionally and should not be modified, use a different channel for your operation.
  </TroubleshootSolution>
</Troubleshoot>

<Troubleshoot>
  <TroubleshootTitle>
    ### SSL verification error
  </TroubleshootTitle>

  <TroubleshootCause>
    This error often occurs when an organization uses internally generated certificates signed by a private Certificate Authority. Internal CAs aren't included in the standard system trust store, so SSL verification fails when the client cannot validate the server's certificate.
  </TroubleshootCause>

  <TroubleshootSolution>
    Run the following command to disable SSL certificate check:

    ```sh theme={null}
    conda repo config --set ssl_verify False
    ```

    Verify the above command worked:

    ```sh theme={null}
    conda repo config --show
    ```
  </TroubleshootSolution>
</Troubleshoot>