Connecting Navigator to other repositories#

Note

  • Business (Cloud) has recently been renamed to Package Security Manager (Cloud).

  • Anaconda Server (Business On-Prem) has recently been renamed to Package Security Manager (On-prem).

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

Note

You can only be signed into one repository service at a time. However, you can be signed into Anaconda Cloud 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) and Anaconda Enterprise 4:

Note

The Anaconda Professional sign in is used for both Anaconda Professional and Package Security Manager (Cloud) connections.

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

  2. Sign in to Anaconda Professional.

  3. Enter your token to log in to your Pro/Package Security Manager instance.

    Where is my token?

    You can issue yourself a private access token from the Token Access page of your Anaconda Cloud 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.

Note

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.

Note

The Anaconda Server sign in is the connection for the Package Security Manager (On-prem).

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

  2. Sign in to Anaconda Server.

  3. If this is your first time logging in, enter your Anaconda Server domain and click Set Domain.

  4. Enter the credentials you use to log in to your Anaconda Server instance.

  5. Click Login. If all credentials are correct, you will be signed in.

(Optional) Add channels from your Server instance to Navigator

After signing in, select channels from the repository integration to use with Navigator.

  1. Select Add to channels to add each channel to the channels: list in your .condarc file.

  2. Select Add to default_channels to add each channel to your default channels.

  3. Click Add channels to save your selections.

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

  2. Sign in to Enterprise 4 Repository.

  3. If this is your first time logging in, enter your Enterprise 4 domain and click Set Domain.

    Caution

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

  4. Enter the credentials you use to log in to your Enterprise 4 platform.

  5. Click Login. If all credentials are correct, you will be signed in.

  6. A message appears asking you to manually add channels to Navigator.

What happens when you connect to a repository#

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

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

  • The conda-repo-cli tool creates a private token for you.

  • Navigator sets the private token in the Navigator config file (anaconda-navigator.ini) file. See Anaconda Server token authentication.

  • Navigator modifies the conda configuration file (.condarc):

    • channels is set to an empty list

    • default_channels, if present, is removed

  • Navigator asks you to manage your channels and default channels.

  • Navigator uses a private token managed by anaconda-client to log in.

  • Navigator modifies the conda configuration file (.condarc):

    • channels is set to an empty list so you can set appropriate channels

    • default_channels, if present, is removed

Note

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.

Anaconda Server token authentication#

Your access token for Anaconda Server 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.

Note

To use other’s private channels in Anaconda Server, see Setting/using a token in the Anaconda Server 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 Anaconda Server. This is mostly system data to help Navigator integrate with Anaconda Server.

Caution

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 or Anaconda Enterprise 4 repository, you enter a domain URL before your login credentials. To change this domain:

  1. Go to Preferences.

  2. In Anaconda Server API domain, enter a valid domain name.

    Note

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

  3. Click Apply to save your changes.

  1. Go to Preferences.

  2. In Enterprise 4 Repository API domain, enter a valid domain name.

    Note

    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 next to 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:

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

  • Navigator removes the access token created for you by conda-repo-cli.

  • Navigator sets logged_api_url, anaconda_server_token, and anaconda_server_token_id to None in the Navigator config file (anaconda-navigator.ini).

  • The conda configuration file (.condarc) returns to the state it was in before the login. (Navigator saves a copy of the .condarc file before a login is attempted.)

  • Navigator uses a private token managed by anaconda-client to log out.

  • The conda configuration file (.condarc) returns to the state it was in before the login. (Navigator saves a copy of the .condarc file before a login is attempted.)

Troubleshooting#

If you are having issues logging in to Anaconda Server or know you’re logged in but cannot interact with Anaconda Server, see Trouble logging in to the Anaconda Server connection in Navigator.