Anaconda Enterprise: Documentation

# Quickstart (AER 2.32)

## Find, download and install packages

### Search for a package

You don’t need an Anaconda Repository account, or even to be logged in, to search for packages, notebooks, environments or installers, and to download and install them.

You do need an account to access private packages without an access token, upload your own or to share your packages, notebooks, environments and installers with others.

1. In the top search box, type part or all of the name of a file you are searching for and press Enter.
2. Packages that match your search string are displayed. Click the name to see more information.

### Refine your search results

You can filter search results using three filter controls:

- All packages, conda only or PyPI only
- All types, Public and/or Private (only available if you are logged in)
- Platforms: All, Source, Linux-32, Linux-64, Noarch, OSX-64, Win-32, Win-64.

“Source” packages are source code only, not yet built for any specific platform.

“Noarch” packages are built to work on all platforms.

### Download and install a package

You can download and install packages using Anaconda Navigator, the graphical user interface for Anaconda Repository. Advanced users may prefer a terminal window or command prompt. Instructions are included for both.

Using Anaconda Navigator

Anaconda Navigator is automatically installed when you install Anaconda. Start Navigator by clicking its program icon on your desktop or in your programs menu.

First, set up Navigator to search your local Anaconda Repository. From the top menu bar, select Preferences. In the “Anaconda API domain” box, enter the address of your local Anaconda Repository and click the Apply button:

NOTE: If your organization does not use HTTPS, type HTTP and un-check the next box, “Enable SSL verification.”

NOTE: If your organization uses subdomains, enter the address like this: `https://api.<your-anaconda-repo>:8080`. If that fails, please check with your Administrator.

Next, sign Navigator into your local Anaconda Cloud (Anaconda Repository) so you can search for packages marked as private. Click the top right “Sign in to Anaconda Cloud” button and enter your Anaconda Repository Username and Password, then click the Apply button:

Download and install a package into its own environment from your Environments tab: from the far right “Search packages” box enter the name of the package. Be sure to select either “not installed” or “all” from the drop-down menu, then click the Search button. Check the checkbox of the package you want to install and click the Apply button. See Navigator for more detailed information.

Using conda in a terminal window or command prompt

After you have located a package on Anaconda Repository and clicked on the name, the detail page displays specific install instructions for the current operating system. Copy and paste the full command into your terminal window.

NOTE: For the following examples to work, you need to have conda downloaded and installed.

EXAMPLE: To download and install a package with conda, run:

    conda install -c username packagename

TIP: Conda automatically expands the “username” to a URL such as `https://<your-anaconda-repo>/username`.

## Build and upload new packages

Building and uploading new packages is optional for advanced users who are comfortable using a Terminal application.

To build and upload packages, install the Anaconda Client command line interface (CLI). Open a Terminal window and enter:

    conda install anaconda-client

Next, still in your Terminal window, log into your Anaconda Repository account:

    anaconda login

At the prompt, enter your Anaconda Repository username and password.

Next, choose the package you would like to build. For this quickstart, you can download our public test package:

    git clone https://github.com/Anaconda-Server/anaconda-client
    cd anaconda-client/example-packages/conda/

To build your test package, first install conda-build and turn off automatic anaconda-client uploading, then run the conda build command:

    conda install conda-build
    conda config --set anaconda_upload no
    conda build .

Check your path to where the newly-built file was placed so you can use it in the next step:

    conda build . --output

Finally, still in your Terminal window, if you haven’t already log into your Anaconda Repository account, then upload your newly-built test package:

    anaconda login
    anaconda upload /your/path/conda-package.tar.bz2

For detailed information, see the Conda packages section.

## Share notebooks

Upload a Jupyter notebook (formerly IPython notebook) to Anaconda Repository:

    anaconda upload my-notebook.ipynb

An HTML version of the notebook will be located at:

    http://notebooks.anaconda.org/<USERNAME>/my-notebook

Anyone who has access to Anaconda Repository can download it:

    anaconda download username/my-notebook

## Share environments

A saved conda environment can be uploaded to Anaconda Repository with the web interface or the `conda env upload` command.

To save the environment:

    conda env export -n my-environment -f my-environment.yml

To use the web interface go to:

    https://<your-anaconda-repo>/<USERNAME>/environments

Then use the Upload button in the top right corner.

To use the `conda env upload` command:

    conda env upload -f my-environment.yml

A list of your uploaded environments is located at:

    http://envs.<anaconda-repo-name>/<USERNAME>

Anyone can download and install your environment from Anaconda Repository:

    conda env create user/my-environment
    source activate my-environment