===============
Troubleshooting
===============

.. contents::

See also :doc:`FAQ <faq>`


What causes an "unable to remove files" error when trying to update or install packages with conda on Windows?
==============================================================================================================

This may result from a file lock issue. Before updating or installing any packages with conda, be sure to terminate any running Anaconda processes such as Spyder or IPython.

If you receive an error message like: ``Error: Unable to remove files for package: <package-name> please close all processes running code from conda and try again.``

You can force the install of the package: ``conda install -f package-name``


What causes an Insecure Platform Warning?
=========================================

The warning "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. Install this updated package to resolve this on Windows::

  conda install ndg-httpsclient

NOTE: You will receive the SSL warning again when initially installing this package.  Once it is installed, the warnings will go away.


On macOS or Linux, what causes a "conda: command not found" error?
==================================================================

Problems with the PATH environment variable can cause ``conda: command not found`` errors or a failure to load the correct versions of python or ipython. To fix these issues, find the location of your Anaconda binary directory, add a line to the file .bashrc in your home directory to add that location to your PATH, and close and re-open your terminal windows. For example, a user with the username jsmith on a Linux machine whose Anaconda binary directory is ``~/anaconda`` could add this line to their .bashrc file::

  export PATH="/home/jsmith/anaconda/bin:$PATH"


Why are files left behind after uninstalling Anaconda on Windows?
=================================================================

Since some users may need to keep setting files and other users may need to delete them, Anaconda leaves some setting 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\Your_User_Name`` or in ``C:\Users\Your_User_Name``.


What can I do if Spyder fails to launch on Windows?
===================================================

1) Try launching it again.
2) On the menu, choose "start" and then "Reset Spyder Settings", then try to launch Spyder again.
3) Launch the command prompt by running "cmd" from the Start menu, then type "Spyder" in the command prompt.
4) Delete the directory ``.spyder2`` from the ``C:\Documents and Settings\Your_User_Name`` directory and then repeat the previous steps.


Why do I get a MKL Trial warning even though MKL-linked packages are now free and installed by default?
=======================================================================================================

Please see the Anaconda MKL documentation on `dismissing MKL Trial 
warnings <../mkl-optimizations/index.html#dismissing-mkl-trial-warnings>`_.


What causes "permission denied" errors when loading MKL shared libraries?
=========================================================================

Please see the Anaconda MKL documentation on `resolving "permission denied" 
errors <../mkl-optimizations/index.html#resolving-mkl-shared-library-permission-denied-errors>`_.


How can I force Miniconda to install?
=====================================

I am getting a conda error and want to reinstall Miniconda to fix it but when I try, it gives me the error that Miniconda (or Anaconda) is already installed and will not let me continue. 

With the Linux and macOS command line installers, you can install Miniconda using the -f (force) option.

Download and install the appropriate Miniconda for your computer operating system from the `Miniconda download page <http://conda.pydata.org/miniconda.html>`_ using the force or -f option as shown::

    bash Miniconda3-latest-MacOSX-x86_64.sh -f

NOTE: Substitute the appropriate filename and version for your operating system.

NOTE: Be sure that you install to the same install location as your existing install so it overwrites the core conda files and does not install a duplicate in a new folder.


What could cause "conda update anaconda" not to install the latest version of Anaconda?
=======================================================================================

Sometimes users have installed packages that are not compatible with the latest version of the Anaconda metapackage. Then running ``conda update anaconda`` will update the Anaconda metapackage to the latest compatible version, but this may not be the latest version.

Running ``conda update anaconda`` or ``conda install anaconda=4.3`` (replacing "4.3" with the latest version number) will show a list of these conflicting packages.

Once you know which packages are conflicting, you can either choose to update all current packages without upgrading to the latest version of Anaconda, or choose to remove the conflicting packages and upgrade to the latest version of Anaconda.

If you choose to update all current packages without upgrading to the latest version of Anaconda, use ``conda remove anaconda`` to remove the Anaconda metapackage itself. This will not remove any of the packages included with Anaconda. Then use ``conda update --all`` to update all currently installed packages.

If you choose to remove the conflicting packages and upgrade to the latest version of Anaconda, remove them with ``conda remove package-name`` for each one, replacing "package-name" with the name of the package. Then run ``conda update anaconda``.


I have a troubleshooting question that is not answered here.
============================================================

Free support for Anaconda is available through the `Anaconda mailing list <https://groups.google.com/a/continuum.io/forum/?fromgroups#!forum/anaconda>`_. For Continuum Analytics installation or technical support options, visit our `support offerings page <http://continuum.io/support>`_.
