============
Anaconda FAQ
============

.. contents::

See also :doc:`Troubleshooting <troubleshooting>`

Now that I have installed Anaconda, what do I do?
=================================================

Take our `30-minute conda test drive <http://conda.pydata.org/docs/test-drive.html>`_, download a `conda cheat sheet <http://conda.pydata.org/docs/_downloads/conda-cheatsheet.pdf>`_ and see our "`Using conda <http://conda.pydata.org/docs/using>`_" section for fun things to do with Anaconda.

How do I install Anaconda on a non-networked machine?
=====================================================

You will need to have a local copy of the appropriate Anaconda installer for the non-networked machine. You can copy the Anaconda installer to the target machine using many different methods including (but not limited to) a portable hard drive, USB drive, or a CD. After you've copied the installer to the non-networked machine, simply follow the :doc:`Anaconda installation instructions <install>`.

How do I install packages on a non-networked machine?
=====================================================

You can directly install a conda package from your local machine by running the following command, and replacing "package-path" and "package-filename.tar.bz2" with your actual path and filename::

  conda install /package-path/package-filename.tar.bz2

Packages installed by conda are found in the anaconda/pkgs directory.

You can also install a tar file (.tar) containing many conda packages by running this command, and replacing "packages-path" and "packages-filename.tar" with your actual path and filename::

  conda install /packages-path/packages-filename.tar

If conda cannot find the file, try using an absolute pathname instead of a relative pathname.

NOTE: Installing packages directly from the file does not resolve dependencies. If your installed package does not work it may have missing dependencies that need to be resolved manually.

How do I move Anaconda from one directory to another?
=====================================================

Anaconda must be be installed in the directory in which you want it to work. So to place Anaconda in a different directory, delete it from the old directory, go to the new directory and install it there following the :doc:`Anaconda installation instructions <install>`.

How do I get help with difficulties installing a package?
=========================================================

The package creators or maintainers may be able to help you with installing the package, or help by building and publishing an updated version. Package creators may also contact Continuum Analytics to submit their package for consideration to be included in Anaconda.

You may also `build your own package <http://conda.pydata.org/docs/building/build.html>`_, and share it with other users on `Anaconda.org <http://anaconda.org>`_.

You can find free community support from the `Anaconda Support Group <https://groups.google.com/a/continuum.io/forum/#!forum/anaconda>`_ or learn about Continuum's other `support options <https://www.continuum.io/support>`_. Continuum also offers custom package builds as one of our `consulting services <https://www.continuum.io/continuum-consulting>`_.

Does Anaconda include Python 2 or Python 3?
===========================================

Anaconda2 includes Python 2.7 and Anaconda3 includes Python 3.5. However, it
doesn't matter which one you download, because you can create new environments
that include any version of Python packaged with conda. See "`Managing Python
with conda <http://conda.pydata.org/docs/py2or3.html>`_".

How can I install specific versions of conda packages?
======================================================

The simplest way to install a specific version of a package is by giving the desired version number (or its prefix) after the package name::

  conda install foo=2.3.4

Or to only specify a major version::

  conda install foo=2

These commands install into the environment that is currently active. You can also install into a named environment::

  conda install foo=2.3.4 -n some_environment

If the package is specific to a Python version, conda will use the version installed in the current or named environment.  More details on versions, dependencies, and channels can be found at "`Conda FAQ <http://conda.pydata.org/docs/faq.html>`_" and "`Conda Troubleshooting <http://conda.pydata.org/docs/troubleshooting.html>`_".

How do I switch an environment from Python 2 to Python 3?
=========================================================

``conda update`` moves up to the latest compatible version, while ``conda install`` can be used to install any version. For example, if Python 2.7.7 is currently installed but the latest version of Python 2 is 2.7.12 and the latest version of Python 3 is 3.5.2, then ``conda update python`` will install Python 2.7.12, while ``conda install python=3`` will install Python 3.5.2. Conda uses the same rules for other packages, so ``conda install`` can always install the highest version, and ``conda update`` will always install the highest version with the same major version number.

How do I install a license file for Anaconda products?
======================================================

After purchasing a license, you will be sent an email containing an attached license file. See our :doc:`license installation <license-installation>` page for full instructions.

How do I set up my IDE to use Anaconda?
=======================================

See our section on :doc:`ide_integration` for more information.

How can I use TKinter with Python 3 in OS X 10.8?
=================================================

OS X 10.8 and later do not come with X11, which must be installed to use TKinter with Python. To correct this problem, download `Xquartz <http://xquartz.macosforge.org/landing/>`_.

How can I use Cython on OS X?
=============================

Cython needs a C compiler, so you'll need to install `Xcode <https://developer.apple.com/xcode/>`_.

How can I use Theano?
=====================

Install `gcc <https://gcc.gnu.org/>`_ and then import Theano. Importing Theano without gcc can cause Python to crash.

NOTE: As shown in the :doc:`package list <pkg-docs>`, Theano is not installed with Anaconda by default. Theano is available for Linux in the default channels and many Anaconda Cloud users have built and shared Theano packages for Windows and macOS.

How is CPython compiled?
============================

* Python 2.6 and 2.7 were compiled with Visual Studio 2008
* Python 3.3 and 3.4 were compiled with VS 2010
* Python 3.5 was compiled with VS 2015

How do you handle linking problems when Python extensions are compiled with gcc?
================================================================================

We resolve linking problems using the mingw import library (the conda package libpython), which Continuum Analytics builds and includes with Anaconda.

How can I configure or opt out of using the Intel Math Kernel Library (MKL)?
============================================================================

Please see the `Anaconda MKL documentation <../mkl-optimizations/>`_
for information on configuring and uninstalling MKL.

How can I use Anaconda on Windows XP?
=====================================

Windows XP is supported on Anaconda versions 2.2 and earlier. Download it from our `archive <https://repo.continuum.io/archive/>`_.

How can I use Anaconda on Mac OS X 10.5 or 10.6?
================================================

Mac OS X 10.5 and 10.6 are supported by the command line installers for Anaconda versions 1.8 and earlier. These are the installer files that end in ".sh" and not ".pkg". Download them from our `archive <https://repo.continuum.io/archive/>`_.

How can I cite Anaconda in an academic paper?
=============================================

If you wish to cite Anaconda in an academic paper, we recommend this format:

*Anaconda Software Distribution*. Computer software. Vers. 2-2.4.0. Continuum Analytics, Nov. 2016. Web. <https://continuum.io>.

How can I get answers to questions not listed 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.html>`_.
