=================
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-4.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 a command prompt or terminal window, you can access additional, 
advanced management features. To learn more, see 
`Managing packages <https://conda.io/docs/using/pkgs.html>`_ with
conda.
