=========================
Installing conda packages
=========================

For more information about using the conda package manager in a Terminal or
Anaconda Prompt, see the `conda
documentation <http://conda.io>`_.

You can also use the graphical interface
:doc:`Anaconda Navigator <../../navigator/index>` to install conda packages
with just a few clicks.

Open an Anaconda Prompt (Windows) or Terminal window (macOS or Linux)
and do the following:


Installing a conda package
==========================

Enter the command::

  conda install package-name

NOTE: Replace ``package-name`` with your package name.

Installing specific versions of conda packages
===============================================

Include the desired version number or its prefix after the package name::

  conda install package-name=2.3.4

NOTE: Replace ``package-name`` with your package name. Replace
``2.3.4`` with the desired version number.

To specify only a major version, run::

  conda install package-name=2

NOTE: Replace ``package-name`` with your package name. Replace
``2`` with the desired version number.

These commands install into the environment that is currently active. To
install into a named environment, run::

  conda install package-name=2.3.4 -n some-environment

NOTE: Replace ``package-name`` with your package name. Replace
``2.3.4`` with the desired version number. Replace
``some-environment`` with your environment name.

If the package is specific to a Python version, conda uses the version
installed in the current or named environment.  For details on versions,
dependencies and channels, see
`Conda FAQ <http://conda.pydata.org/docs/faq.html>`_ and
`Conda Troubleshooting <http://conda.pydata.org/docs/troubleshooting.html>`_.


Installing packages on a non-networked (air gapped) computer
============================================================

To directly install a conda package from your local computer, run::

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

NOTE: Replace ``package-path`` and ``package-filename.tar.bz2`` with your actual path and filename.

Conda installs packages into the ``anaconda/pkgs`` directory.

To install a .tar file containing many conda packages, run the following command::

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

NOTE: Replace ``package-path`` and ``package-filename.tar`` with your actual path and filename.

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

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.
