Troubleshooting
This page details some common issues and their respective workarounds. For Anaconda installation or technical support options, visit our support offerings page.
You can search this page for information using your browser’s search function: Ctrl+F (Windows)/Cmd+F (Mac).
Conda: Channel is unavailable/missing or package itself is missing
Cause
Cause
After you have configured your .condarc on either the Pro (legacy) or Business tier, in some cases you may be unable to install packages.
Solution
Solution
One potential fix for all of these is to run the following command:
This will clear the “index cache” and force conda to sync metadata from the repo server.
Receiving a 403 error from an Anaconda channel
If you are working with the Anaconda-hosted conda-forge and are receiving a 403 error, see Receiving a 403 error from hosted conda-forge instead.
Cause
Cause
A 403 errors is a generic Forbidden error issued by a web server in the event the client is forbidden from accessing a resource.
The 403 error you are receiving may look like the following:
There are a few possible reasons for receiving this error:
- You have misconfigured the channels in your
.condarcfile. - A firewall or other security device or system is preventing user access.
- Access is blocked due to a potential terms of service violation.
Solution
Solution
First, double-check your channel configurations and verify that the address has been entered correctly.
If that fails, speak with your IT administrator to ensure your proxy or firewall is not blocking traffic to the repository channels.
If you are sure traffic is not being blocked and your issue persists, open a support ticket.
HTTP 000 CONNECTION FAILED
Cause
Cause
This is generally caused by a proxy misconfiguration, which can be corrected by setting your proxy servers correctly. However, because some businesses do not have an easy method of providing their SSL cert, Anaconda recommends bypassing the SSL verification step if you encounter this error.
Solution
Solution
If you receive this error message, first run the following command:
(Package Security Manager users) If necessary, install conda-token by running the following command:
(Package Security Manager users) Ensure the token verification step ignores SSL errors by running the following command:
You may see the following warning, though you can safely ignore it:
Environment creation failing due to policy filter
Cause
Cause
Implementing strict policy filters with no exceptions can cause essential package dependencies to be filtered out of your repository. Without these packages, commands like conda create --name <ENV_NAME> python=3.11 will fail.
If you are attempting to create a new environment, but your build is failing due to package conflicts or unavailable packages, it’s likely due to your IT team’s strict policy filter. You can request that package exceptions can be added to a policy filter, but you’ll need to know which packages are causing problems first.
Solution
Solution
To perform this test, you’ll need a channel that has no policy filter applied to it. Create the channel in your organization and name it quarantine. Once created, add it to your .condarc file. For help adding a channel to your .condarc file, see Channels.
With your quarantine channel created and added to your .condarc file, you can run the following command:
If you have your channel alias set in your .condarc, you can use just the channel name with the --channel argument. If you do not, you can use the full channel URL with the --channel argument. You can copy the channel URL from your Channels page. For more information on setting your channel alias, see Using the .condarc conda config file.
For example, if you are trying to test building an environment from the snakes channel, the command would be:
The ordering of snakes and quarantine is essential. Conda will attempt to solve the environment in the order the channels are listed, so quarantine must be listed last.
Example command return:
Packages that were retrieved from the quarantine channel are the packages that need to be considered for exceptions in the policy filter.
Receiving a 403 error from hosted conda-forge
Cause
Cause
If you have established a connection to the Anaconda-hosted conda-forge channel and have started receiving 403 errors when you were not receiving them initially, it is likely that you have recently reissued yourself a token. This issue stems from this newly issued token not having the permissions that were provided to the previous token.
Your 403 error might look like this:
Solution
Solution
To provide permissions for the conda-forge channel to your newly issued token, navigate to your organization’s Token Access page and click Sync token.