Connecting Navigator to other repositories

Navigator integrates with Anaconda’s free, public repository and premium, curated repository through different connection points. For more information, see our pricing page.

You can only be signed into one repository service at a time. However, you can be signed into Anaconda.com while also signed into a repository service.

How to connect to other repositories

This guide takes you through the connection setup for Package Security Manager (Cloud and On-prem):

Anaconda Enterprise 4 is deprecated.

PSM (Cloud)

1. Click Connect in the top-right corner of the Navigator application.

2. Sign in to Package Security Manager Cloud.

3. Enter your token to log in to your Package Security Manager (Cloud) instance.

   Where is my token?

   You can issue yourself a private access token from the Token Access page of your Anaconda.com organization. You must be assigned a seat to issue yourself a token. If you’ve lost your token, you can re-issue yourself a new token at any time. Re-issuing a token invalidates the previous token.

   For more information, see Authenticating to Anaconda in the Package Security Manager (Cloud) quickstart.

4. Click Set Token. If your token is valid, you will be signed in.

   

For more information on adding channels from your Package Security Manager (Cloud) repo to Navigator, see Adding an organization channel to your .condarc file in the Package Security Manager (Cloud) documentation.

What happens when you connect to a repository

Navigator performs a few actions for you automatically when you connect to your repository:

Package Security Manager

• The conda-token tool sets your supplied organization token and automatically manages default_channels.

If you have already logged in to your repository using a CLI, Navigator detects that when it opens and shows a connection to that repository automatically. If you log out from your repository connection in Navigator, your CLI session is also affected accordingly.

Package Security Manager (On-prem) token authentication

Your access token for Package Security Manager (On-prem) provides you with the ability to access your own private server channel. The access token is stored locally, which gives conda native access to your remote channel and packages.

To use other’s private channels in Package Security Manager (On-prem), see Setting/using a token in the Package Security Manager documentation.

The variables anaconda_server_token and anaconda_server_token_id in the Navigator config file (anaconda-navigator.ini) are also updated when you first connect to Package Security Manager (On-prem). This is mostly system data to help Navigator integrate with Package Security Manager (On-prem).

The token and token ID config variable names have been updated from team_edition_token to anaconda_server_token and team _edition_token_id to anaconda_server_token_id as of Version 2.4.0. If you downgrade your Navigator application to a version older than 2.3.0, you will need to manually change these variable names back to their older versions within your anaconda-navigator.ini file.

Changing the repository connection domain

When you first connect Navigator to a Server repository, you enter a domain URL before your login credentials. To change this domain:

1. Go to Preferences.

2. In PSM On-Prem API domain, enter a valid domain name.

   The domain must be a full path without a trailing slash. For example: http(s)://mysite.com

3. Click Apply to save your changes.

How to disconnect from a repository

You can only be connected to one repository at a time.

To disconnect from a repository:

1. Click Connect.
2. Click Sign out beside the repository you are signing out of.

Channels that you have added to Navigator from Anaconda.org or a professional (repo.anaconda.cloud) repository are not automatically removed when you disconnect from those repositories. Navigator will still search those channels and install packages from them. If you no longer want those channels to be searched:

1. Open Preferences from the File, Anaconda Navigator, or python menus, depending on your setup.

2. Click Configure Conda.

3. Delete any channels in the channels: list that you no longer want to be connected to. Anaconda recommends against deleting defaults.

   For example, let’s say you have disconnected from a Package Security Manager repository and have the following channels: list:

   channels:
       - https://repo.anaconda.cloud/t/<TOKEN>/repo/business-org-name/channel1
       - https://repo.anaconda.cloud/t/<TOKEN>/repo/business-org-name/channel2
       - defaults
   

   You would delete the first two lines and leave defaults in your channels: list.

   channels:
       - defaults
   

4. Click Save and Restart.

What happens when you disconnect from a repository

Navigator performs a few actions for you automatically when you disconnect from your repository:

Package Security Manager (Cloud)

• The conda-token tool removes your supplied organization token.

Troubleshooting

If you are having issues logging in to Package Security Manager (On-prem) or know you’re logged in but cannot interact with Package Security Manager (On-prem), see Trouble logging in to the Package Security Manager (On-prem) connection in Navigator.