Troubleshooting

After you have configured your .condarc on either the Pro (legacy) or Business tier, in some cases you may be unable to install packages. You may receive an error message that the channel or package is unavailable or missing.

One potential fix for all of these is to run the following command:

conda clean --index-cache

This will clear the “index cache” and force conda to sync metadata from the repo server.

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:

Collecting package metadata (current_repodata.json): failed

UnavailableInvalidChannel: The channel is not accessible or is invalid.
  channel name: pkgs/main
  channel url: https://repo.anaconda.com/pkgs/main
  error code: 403

You will need to adjust your conda configuration to proceed.
Use `conda config --show channels` to view your configuration's current state,
and use `conda config --show-sources` to view config file locations.
There are several reasons a 403 error could be received:

There are a few possible reasons for receiving this error:

• The user has misconfigured their channels in their configuration. For example, the secure location where the token is stored was accidentally deleted (most common).
• A firewall or other security device or system is preventing user access (second most common)
• We are blocking their access because of a potential terms of service violation (third most common)

1. First, run the following to undo your configuration:

   conda config --remove-key default_channels
   

   When conda is first installed, the default channels it uses to install packages are https://repo.anaconda.com/main and https://repo.anaconda.com/r (as well as https://repo.anaconda.com/msys2 for Windows operating systems).

2. If your other channels require a token, install or upgrade the conda-token tool by running the following command:

   conda install --freeze-installed conda-token
   

3. Lastly, re-apply the token and configuration settings:

   # Replace <TOKEN> with your token
   conda token set <TOKEN>
   

If this doesn’t resolve the issue, Anaconda recommends consulting our Terms of Service error page.

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.

If you receive this error message, first run the following command:

conda config --set ssl_verify false

(Package Security Manager users) If necessary, install conda-token by running the following command:

conda install conda-token --name base

(Package Security Manager users) Ensure the token verification step ignores SSL errors by running the following command:

# Replace <TOKEN> with your token
conda token set --no-ssl-verify <TOKEN>

You may see the following warning, though you can safely ignore it:

/Users/<USERNAME>/Applications/miniconda3/lib/python3.7/site-packages/urllib3/connectionpool.py:1020: InsecureRequestWarning: Unverified HTTPS request is being made to host 'repo.anaconda.cloud'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/latest/advanced-usage#ssl-warnings
InsecureRequestWarning,

The conda shell function is not available or is not working properly. Some causes may include:

• You didn’t restart your shell after installing Anaconda or Miniconda.
• You didn’t allow the installer to modify your startup script.
• Conda has been corrupted, usually by a change in the Python package (e.g. 3.9->3.7).
• You have set auto_activate_base to false.

If your install is new, close and reopen your terminal application. If you want your terminal to remain open, you can source your ~/.zshrc file (in macOS) or ~/.bashrc file (in Linux). When you “source” a script, your terminal re-reads it and applies the changes, which usually only happens when the terminal is first opened.

source ~/.zshrc

To initialize conda in your current terminal, run the following command, depending on your operating system:

# Replace <PATH-TO-CONDA> with the file path to your conda installation
<PATH-TO-CONDA>/bin/conda init zsh

~/anaconda3/bin/conda init zsh

To see the value for auto_activate_base, run the following command:

conda config --describe auto_activate_base

If your terminal returns false, this means that conda is not automatically activating your base environment when you start a new shell. This behavior emulates your system Python, and some users prefer to have their conda environment be inactive until they need it. However, this is not conda’s default behavior after installation.

To change the value of auto_activate_base, run the following command:

# Replace <TRUE_OR_FALSE> with true or false
conda config --set auto_activate_base <TRUE_OR_FALSE>

If you have auto_activate_base set as false, the conda command will still be available as a shell function, but your base environment will not be active when a new shell is started. To activate your base environment, run conda activate.

If you have installed packages that are incompatible with the latest version of the Anaconda metapackage, running conda update anaconda updates the Anaconda metapackage to the latest compatible version. Keep in mind this might not be the latest version.

1. Obtain a list of the conflicting packages by running conda update anaconda or conda install anaconda=2023.07.

   Replace 2023.07 with the latest version number.

2. Enter n to cancel the installation or update.

3. Once you know which packages are conflicting, you can:

   • update all current packages without upgrading to the latest version of the anaconda metapackage, or
   • remove the conflicting packages and then upgrade to the latest version of the anaconda metapackage.

To update all current packages without upgrading to the latest version of the anaconda metapackage:

1. Remove the anaconda metapackage itself by running the following command:

   conda remove anaconda
   

2. Update all currently installed packages by running the following command:

   conda update --all
   

To remove the conflicting packages and upgrade to the latest version of the anaconda metapackage:

1. Remove the conflicting packages by running the following command for each one:

   conda remove <PACKAGE>
   

2. Update to the latest version of the anaconda metapackage:

   conda update anaconda
   

1. Download a new installer, then follow the instructions for your operating system.

1. Run conda list to view the packages from the previous installation.
2. Run conda info -e to list the environments created in the previous installation, which are now available in the new installation.

InsecurePlatformWarning appears only when the installed version of Python is older than version 2.7.9. This message warns only that the validity of the SSL connection is not being verified. It should not affect your package downloads.

To resolve this, install the updated package ndg-httpsclient:

conda install ndg-httpsclient

If anaconda-client is not installed and you search for a package on anaconda.org using the Anaconda search command…

# Replace <PACKAGE> with the name of a package you want to search for
anaconda search --package-type conda <PACKAGE>

…You will receive the following error message:

'anaconda' is not recognized as an internal or external command,
operable program or batch file.

To resolve the error:

1. Install anaconda-client by running the following command:

   conda install anaconda-client
   

2. Search for a package:

   # Replace <PACKAGE> with the name of the package you are looking for
   anaconda search --package-type conda <PACKAGE>
   

When installing or searching for a package, you may see the process end abruptly with a “Killed” message:

$ conda install numpy
Collecting package metadata (current_repodata.json): done
Solving environment: failed with initial frozen solve. Retrying with flexible solve.
Collecting package metadata (repodata.json): - Killed

This may be because your system lacks the sufficient disk space or memory to complete the process.

Verify that you have enough disk space and memory on your system to install and use Anaconda packages. The minimum system requirements for Miniconda and Anaconda installers can be found in the conda user guide.

When compiling Python extensions with gcc on Windows, linking problems may result.

To resolve these linking problems, use the conda package libpython, a mingw import library that Anaconda builds and includes with the Anaconda Distribution.

Generally, this is caused by a file lock issue.

Before updating or installing any packages with conda, be sure to terminate any running Anaconda processes, such as Navigator, Spyder, or IPython.

You can also force the installation of the package:

# Replace <PACKAGE> with the name of the package you want to install
conda install --force-reinstall <PACKAGE>

When working with both versions, add the path to your installer files to the PATH.

To get the information about conda, including your PATH, run the following command:

conda info -a

When you were installing Anaconda or Miniconda, you most likely answered “No” to the question about prepending the conda prompt to your PATH.

This error occurs when the installation attempts to write to a directory for which it does not have write permissions.

Manually select an appropriate install location. The following example shows how to select your user’s home directory.

1. Re-run the installer and click through until you reach either the Installation Type or Destination Select page.

2. If you reach the Installation Type page first, click Change Install Location…. This will take you to the Destination Select page.

3. Click Install on a specific disk….

4. Select the appropriate destination drive. Then click Choose Folder….

5. Select your user’s home directory (e.g. /Users/john.doe/). Then click Choose.

6. In the message box, confirm the name of the install folder you chose in the previous step. Then click Continue.

7. Click Install, and then proceed with the rest of the installation.

If you continue to receive the same error message, please open an issue here, and be sure to include the installation log output from your install.log file, which can be found at /var/log/install.log.

The Anaconda installer files are large (over 600 MB), and some users have problems with errors and interrupted downloads when downloading large files.

This situation can occur if you are getting a conda error and you want to reinstall Miniconda to fix it.

For macOS and Linux, download and install the appropriate Miniconda for your operating system from the Miniconda download page using the --force or -f option by running the following command:

# Replace the name of the installer if you need a different version or operating system
bash ~/Downloads/Miniconda3-latest-MacOSX-x86_64.sh -f

When running the .pkg installer, you may see this message at the end of the installation:

If so, check for the following:

1. Open your /var/log/install.log file and check whether the most recent lines show errors following a call to conda init --all.

   open /var/log/install.log
   

2. In your $HOME directory, check whether the owner of your shell config files is root:

   ls -la ~/.bash_profile ~/.config/fish/config.fish ~/.tcshrc ~/.xonshrc ~/.zshrc
   

If both of the above are true, do the following:

1. Change the owner of your shell config files to your current user:

   sudo chown -R $USER ~/.bash_profile ~/.config/fish/config.fish ~/.tcshrc ~/.xonshrc ~/.zshrc
   

2. Uninstall the previous installation. Then re-run the installer, making sure to select the Install for me only option.

This may be caused by the way Windows updates the Start menu, or by having multiple versions of Python installed that are interfering with one another. Existing Python installations, installations of Python modules in global locations, or libraries that have the same names as Anaconda libraries can all prevent Anaconda from working properly.

If Start menu shortcuts are missing, Microsoft recommends rebooting your computer or restarting Windows Explorer.

If that doesn’t work, clear your $PYTHONPATH environment variable, if applicable, and re-install Anaconda.

Other potential solutions are covered in the “Conflicts with system state” section of the following blog post.

Try these solutions, in order:

• Do not install on a PATH longer than 1024 characters.
• Turn off anti-virus programs before installing, then turn the anti-virus programs back on.
• Uninstall all previous Python installations.
• Clear all PATHs related to Python in sysdm.cpl file.
• Delete any previously set up Java PATHs.
• If JDK is installed, uninstall it.

If a user chooses to add Anaconda to the Windows PATH, this can cause programs to use the new Anaconda versions of software (like Python) and not the versions that were already in place. In some cases, this can cause incompatibility and errors.

Anaconda recommends against adding Anaconda to the Windows PATH manually. Instead, use Anaconda software by opening Anaconda Navigator or Anaconda Prompt from the Start Menu.

Some users may need to keep settings files and other users may need to delete them, so Anaconda leaves some settings files in place when it is uninstalled. Specifically, the directories .spyder2, .ipython, .matplotlib, and .astropy remain. Depending on your version of Windows, these may be in C:\Documents and Settings\<USERNAME> or in C:\Users\<USERNAME>.

Manually delete any unneeded settings files.

This may be caused by errors in the Spyder setting and configuration files.

1. Close and relaunch Spyder and see if the problem remains.

2. Open the Start Menu and then click Reset Spyder Settings and see if the problem remains.

3. Close Spyder and relaunch it from Anaconda Prompt with the following command:

   spyder
   

4. Delete the directory .spyder2 and then repeat the first item in this list. Depending on your version of Windows, .spyder2 may be in C:\Documents and Settings\<USERNAME> or in C:\Users\<USERNAME>.

This occurs when running the uninstaller by choosing Control Panel > Uninstall a program, selecting Anaconda or Miniconda from the list of programs, and clicking Uninstall.

Open the anaconda3 or miniconda3 installation folders and run the .exe file uninstaller from that location. Uninstallation will complete without prompting for administrative privileges.

EXAMPLE: If you installed Miniconda3, the uninstall file will be Uninstall-Miniconda3.exe. Users who installed Miniconda2 or Anaconda will find a similar file with the appropriate name.

The Windows Favorites folder has unusual permissions and may cause permission errors with installers of any software. If you try launching the installer from the Favorites folder, you may see errors such as “Setup was unable to create the directory”, “Access is denied”, or “Error opening file for writing”.

Move the installer to a different folder and run the installer from the new folder.

1. Open a Command Prompt window.

2. Navigate to where you installed conda. The following command shows the default:

   cd C:\Users\<USERNAME>
   

3. Run the following command:

   python -m conda init
   

4. Close the Command Prompt window.

conda update conda

If you did not initialize conda when you installed it on your macOS computer, or if you uninstalled and reinstalled zsh (or deleted your .zshrc file), your zsh shell will be unable to use conda commands properly.

To initialize conda for zsh:

1. Open a terminal application and run the following command:

   # Replace <PATH-TO-CONDA> with the file path to your conda installation
   <PATH-TO-CONDA>/bin/conda init zsh
   

   For example, if you installed Miniconda to the default location with the .sh installer (~/miniconda3/), the command would be:

   ~/miniconda3/bin/conda init zsh
   

2. Close and reopen your terminal application.

This is because of the command-line flags returned by python3-config. Before Python 3.8, those are needed to embed the core Python interpreter into a different project altogether and not those that should be used when linking a Python extension module.

Python modules should never link to the core Python interpreter library directly, either statically at build time or dynamically at runtime. This is because the Python executable itself provides all the necessary functions and symbols.

You should only use python*-config —ldflags when linking to an interpreter library (either static or shared).

python3-config doesn’t include the command/compiler name, whereas the sysconfig way does. This works provided none of your arguments have spaces:

python -c "import sysconfig; print(' '.join(sysconfig.get_config_var('LDSHARED').split(' ')[1:]))"

Most Power8 Linux distributions include libgomp, but some may not.

Check whether the system is missing libgomp by running the following command:

conda inspect linkages --name root numpy

If libgomp.so.1 is listed in the not found: section, it must be installed.

Install libgomp on Ubuntu by running the following command:

apt install libgomp1

Install libgomp on Red Hat Enterprise Linux (RHEL) or CentOS by running the following command:

yum install libgomp

Anaconda on Power8 only supports little endian mode. The little endian Python binary will not execute on a big endian operating system.

Install Anaconda on Power8 on a little endian Linux installation or VM.

The package conda-package-streaming requires certain encoding variables that fresh installations of Linux may not have properly set, causing an ASCII error and a failed installation of Anaconda Distribution.

1. Add the following to your current shell config file (.bashrc, .zshrc, etc.):

   export LANGUAGE="en_US.utf8"
   export LC_ALL="en_US.utf8"
   export LC_CTYPE="en_US.utf8"
   export LANG="en_US.utf8"
   

2. If your installer partially ran before failing, your installation directory may not be empty. If so, delete your installation directory.

3. Rerun your installer.

If you are using Navigator version 2.6.3 and are unable to update to version 2.6.4, it might be because of a dependency conflict between the anaconda-navigator package and the anaconda-toolbox package. (Each package lists incompatible versions of anaconda-cloud-auth as a dependency.)

To check if you have the anaconda-toolbox package, open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

conda list anaconda-toolbox

To solve the dependency conflict between anaconda-navigator and anaconda-toolbox:

1. Navigator, if open.

2. Open Anaconda Prompt (Terminal on macOS/Linux).

3. Run the following command:

   conda install --name base anaconda-navigator=2.6.4 anaconda-toolbox=4.1.0
   

4. Enter y to approve the package changes.

   Once your base environment is updated, it is safe to close Anaconda Prompt/Terminal.

5. Reopen Navigator.

Once this dependency conflict is resolved, any future updates to Navigator can be accomplished as usual. See Updating Navigator.

This is often the result of a corrupted .condarc file.

To resolve, delete the .condarc file and restart Navigator.

1. Find the .condarc file.

   Open Anaconda Prompt (Terminal on macOS/Linux) and enter the command conda info. The output will tell you the location of your .condarc file(s). You can also search for “.condarc” on your computer.

   The .condarc file is frequently found in:

   • macOS: /Users/<USERNAME>
   • Linux: ~/.condarc
   • Windows: C:\\Users\\<USERNAME>

2. Optional: Save custom configurations.

   If you had custom configuration in your .condarc file before it was corrupted, save the information to add that configuration back to the new file.

3. Delete the .condarc file.

4. Restart Navigator.

Issues launching or initializing Anaconda Navigator may be caused by permission or licensing problems.

• If you cannot launch the Anaconda Navigator desktop app via its desktop or application shortcut, you might still be able to launch it via Anaconda Prompt (Terminal on macOS/Linux). Enter the following command:

  anaconda-navigator
  

• If you have permissions issues, there may be a problem with the hidden licenses directory, .continuum. To delete the .continuum directory, open Anaconda Prompt (Terminal on macOS/Linux) and run the following command, depending on your operating system:

  Windows

  macOS/Linux

  rd /s .continuum
  

  Then, relaunch Navigator from the desktop app or Anaconda Prompt (Terminal on macOS/Linux).

• If removing the licenses directory does not resolve the issue, manually update Navigator by opening Anaconda Prompt (Terminal on macOS/Linux) and running the following command:

  conda update --name base anaconda-navigator
  

• If you have updated Navigator and still have problems, remove and reinstall Anaconda Navigator by opening Anaconda Prompt (Terminal on macOS/Linux) and running the following command:

  conda remove --name base anaconda-navigator
  conda install --name base anaconda-navigator
  

• If none of the above work, reset the Anaconda Navigator configuration back to default values by opening Anaconda Prompt (Terminal on macOS/Linux) and running the following command:

  anaconda-navigator --reset
  

macOS Catalina users may experience permission errors where the system does not prompt you for permission to folders requiring access.

1. Update Navigator by opening Anaconda Prompt (Terminal on macOS/Linux) and running the following command:

   conda update --name base anaconda-navigator
   

2. Once updated, have Navigator generate the permissions prompt by launching Spyder and running the following in the console:

   # Replace <DIRECTORY> with the folder you need access to
   import os
   os.listdir('<DIRECTORY>')
   

This is caused by a lock file that sometimes gets stuck and isn’t removed when it should be.

Open Anaconda Prompt (Terminal on macOS/Linux) and remove the lock file by running the following commands:

conda update --name base conda anaconda-navigator navigator-updater
anaconda-navigator --reset

The disappearance of Navigator buttons may be caused by an out of sync repodata, a corrupt .condarc file, or an unknown issue.

1. Run Update Index from the Environments page of Navigator.
2. Quit and restart Navigator.

If that solution doesn’t work, try one of the following:

• Confirm that your .condarc file is not corrupt. Specifically confirm that your channel settings contain defaults.

• Open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

  conda search python
  

  This downloads a fresh copy of the repodata, which should resolve the problem.

• If none of the above options work, open an issue detailing the error.

1. Set logged_api_url, anaconda_server_token, and anaconda_server_token_id in the Navigator config file (anaconda-navigator.ini) to None.

   The token and token ID config variable names have been updated from team_edition_token to anaconda_server_token and team _edition_token_id to anaconda_server_token_id as of Version 2.4.0. If you downgrade your Navigator application to a version older than 2.3.0, you will need to manually change these variable names back to their older versions within your anaconda-navigator.ini file.

2. Remove channel_alias from the conda configuration file (.condarc).

3. Try signing in again.

Anaconda Navigator displays and launches VS Code, and many other applications, through that application’s executable file. VS Code’s installation should have placed the executable in a specific directory where Navigator is programmed to look. For example:

• Windows User-Only Installation: C:\\Users\\User\\AppData\\Local\\Programs\\Microsoft VS Code
• Windows System-Wide Installation: C:\\Program Files\\Microsoft VS Code
• Linux-64: /usr/share/code
• macOS: /Applications

There are two options for solving this issue:

• Reinstall VS Code to ensure that executable is installed in the default location.

  1. Close Navigator.

  2. Uninstall (if necessary) and reinstall VS Code.

     On macOS, make sure the VS Code application is moved from your Downloads folder to your Applications folder.

  3. Re-open Navigator.

• If you have installed VS Code to a different location than the default, edit VS Code’s path in your Navigator user preferences.

  1. Open the Anaconda Navigator Preferences dialog from the top menu bar (such as File > Preferences or Anaconda Navigator > Preferences).

  2. Scroll down to the VS Code path setting.

  3. Enter the path to the installation of VS Code you would like Anaconda Navigator to use. This may be similar to the examples above, especially if you have a user-specific installation you would rather use over your system-wide installation.

     You do not need to enter the name of the executable file itself. Just the path to the folder that contains that file.

  4. Close and reopen Navigator.

This error is likely due to anaconda-client being installed with admin rights. This will lead to incorrect user permissions for the anaconda-client config file.

You can do a few things to solve this. They are listed from most straightforward to most complex.

Delete your .continuum folder

1. Back up your .config.yaml file to a different location.
2. Delete your .continuum folder.
3. Start Navigator again.
4. Copy your saved .config.yaml file back into /.continuum/anaconda-client.

Uninstall and reinstall without admin privileges

Uninstall Anaconda and then reinstall Anaconda without admin privileges.

Manually change the .continuum folder’s user permissions

You will need administrator privileges to do this.

Users with unverified Anaconda.org email addresses can no longer access the API that Navigator and Anaconda Client use to communicate with Anaconda.org. Navigator 2.5.0+ now catches this error and logs you out of your Anaconda.org connection.

To connect to Anaconda.org again through Navigator, update your Navigator version or verify your Anaconda.org account.

Verify your anaconda.org account

To fully resolve the issue, we recommend verifying your account on Anaconda.org:

1. Log in to your Anaconda.org account.
2. If your email is unverified, you will be prompted to verify it.
3. Click Resend Confirmation Email.
4. Follow the instructions in the email you receive to complete the verification process.

In the CentOS 7 Linux operating system, Orange3 is missing some graphics libraries required by Qt, a framework that Orange Canvas requires to work.

These missing dependencies cause an error when starting Navigator: “Could not load the Qt platform plugin “xcb” in “” even though it was found. This application failed to start because no Qt platform plugin could be initialized.”

1. Open a terminal application.
2. Install the missing system libraries and run updates by running the following commands:

sudo yum install xcb-util-wm xcb-util-image xcb-util-keysyms xcb-util-renderutil
sudo yum update

Once these libraries are installed and updated, Orange3 should launch correctly on CentOS 7 and the above error should no longer appear when opening Navigator with Orange3 installed.

In Navigator versions 2.5.0 and later, a dialog appears every hour (or every 24 hours as of version 2.6.2) to remind users to log in to Anaconda Cloud, if they are not already logged in. This can be disruptive to users who do not want to log in to Anaconda Cloud.

There are a few ways to disable the Anaconda Cloud login reminder, depending on your version of Navigator:

If you are not automatically prompted to update Navigator upon sign in, there can be several reasons why.

• The dialog has been hidden
• Your package index is out of sync
• defaults is missing from your channels list

The dialog has been hidden

You might have clicked Do not show again in the Update popup. If this is the only reason your update popup is failing to appear, you should still see the Update now option beside Connect. To update, click Update now.

To have the Update popup appear automatically again:

1. Open Preferences from the File or Anaconda Navigator menu.
2. Deselect Hide update dialog on startup.

Your package index is out of sync

Navigator fails to recognize an update is available if your package table is not properly updated. To update your package table, click Environments, then Update index….

defaults is missing from your channels list

Not having defaults added to your channels list can also cause Navigator’s Update popup to fail to appear.

To add defaults to your channels list:

1. Click Channels on the Home or Environments page.
2. Click Add.
3. Enter defaults, then press Enter (Windows)/Return (Mac) on your keyboard.
4. Click Update channels.
5. Close and reopen Navigator.

The captcha may be blocked by an ad blocker extension, tracking blocker extension, or Firefox’s privacy settings.

1. Refresh your browser and try again. If refreshing multiple times, wait a few seconds between each refresh.
2. Check your extensions. Extensions that block tracking or ads may also block the captcha.
3. Check your browser settings. Privacy settings may block the captcha.
4. Open the sign in page in a private browsing window.

The Notebooks and Environments features have been removed from Anaconda.org as part of an initiative to streamline and improve Anaconda.org and enable the site to focus on package hosting and management. Because of this, notebook and environment files can no longer be uploaded to Anaconda.org using the anaconda upload command.

Although you can no longer upload notebooks to Anaconda.org, you can share your notebooks with others using Anaconda Notebooks instead. Anaconda Notebooks come with their own preloaded Environments and allow you to create your own custom environments as well. For more information on sharing notebooks with Anaconda Notebooks, see Sharing notebooks.