=================
Managing packages
=================

.. contents::
   :local:
   :depth: 1

On the Navigator **Environments** tab, the packages table in the right
column lists the packages included in the environment selected in the
left column.

NOTE: Packages are managed separately for each environment.
Changes you make to packages only apply to the active environment.

TIP: Click a column heading in the table to sort the table by package
name, description, or version.

.. figure:: /img/navigator-environments-1-6.png
   :width: 60%

   ..

|

TIP: The Update Index button updates the packages table with all
packages that are available in any of the enabled channels.

Filtering the packages table
============================

By default, only Installed packages are shown in the packages table.
To filter the table to show different packages, click the arrow next to
Installed, then select which packages to display: Installed,
Not Installed, Upgradable or All.

NOTE: Selecting the Upgradable filter lists packages that are installed
and have upgrades available.

Finding a package
=================

In the Search Packages box, type the name of the package.

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

#. Select the Not Installed filter to list all packages that are
   available in the environment's channels but are not installed.

   NOTE: Only packages that are compatible with your current environment
   are listed.

#. Select the checkbox next to the package you want to install, or in
   the Version column, click the blue up arrow.

#. Click the Apply button.

TIP: If after installing a new package it doesn't appear in the packages
table, select the **Home** tab, then click the Refresh button to reload
the packages table.

Upgrading a package
===================

#. Select the Upgradable filter to list all installed packages that have
   upgrades available.
#. Select the checkbox next to the package you want to upgrade, then in
   the menu that appears select Mark for Upgrade.

   OR

   In the Version column, click the blue up arrow.

#. Click the Apply button.

Installing a different package version
======================================

#. Select the checkbox next to the package whose version you want to
   change.
#. In the menu that appears, select Mark for specific version installation.

   If other versions are available for this package, they are displayed in a list.

#. Click the package version you want to install.
#. Click the Apply button.

Removing a package
==================

#. Select the checkbox next to the package you want to remove.
#. In the menu that appears, select Mark for Removal.
#. Click the Apply button.

Advanced package management
===========================

Navigator provides a convenient graphical interface for managing conda
environments, channels and packages. But if you're comfortable working
with Anaconda prompt (Terminal on Linux or macOS), you can access additional, 
advanced management features. To learn more, see
`Managing packages <https://conda.io/docs/using/pkgs.html>`_ with
conda.
