Editing Navigator and conda configuration files#

You can edit Navigator and conda configuration files through either the Navigator Preferences dialog or in your preferred text editor.

Caution

Be careful when changing values directly in the configuration files for Navigator or conda. Incorrect configuration can cause issues with these products.

Editing with the Navigator Preferences dialog#

  1. In Anaconda Navigator, open the Navigator Preferences dialog.

    Open the File menu and click Preferences.

    Open the Anaconda Navigator or python menu and click Preferences.

  2. Click Configure Navigator to open the anaconda-navigator.ini file or click Configure Conda to open the .condarc file within Navigator.

  3. Edit the file to change any configurations.

    When you edit the Navigator and conda configuration files in Navigator, a validation tool warns you about missed requirements or incorrect formatting. The .condarc file must be a valid .yaml format file.

  4. Click Save and Restart to save any changes to the open configuration file and restart Navigator.

Editing with your preferred text editor#

Follow these steps to locate, open, and edit the .condarc or anaconda-navigator.ini files in your preferred text editor:

  1. Open your .condarc file in your text editor of choice.

    Where is my .condarc file?

    To locate your .condarc file, open Anaconda Prompt (Terminal on macOS/Linux) and run the following command:

    conda config --show-sources
    

    Example return:

    ==> /Users/<USERNAME>/.condarc <==
    channels:
    - defaults
    

    While the .condarc is most likely in your Home directory, it is a hidden file, and is not visible in file browsers under normal circumstances. For help viewing hidden files on:

    For more information on viewing hidden files and folders in Windows, see View hidden files and folders in Windows in Microsoft’s documentation.

    To view hidden files on macOS, use Shift+Cmd+. in your Finder.

    To view hidden files on Linux, use Alt+. or Ctrl+H (depending on your file manager).

  2. Make and save your changes.

    The .condarc file must be a valid .yaml format file.

  3. Close and reopen Navigator or any Anaconda Prompt or command line windows.

  1. Open your anaconda-navigator.ini file in your text editor of choice.

    Where is my anaconda-navigator.ini file?

    The anaconda-navigator.ini file is created after you have opened Navigator for the first time. It is located in the navigator folder, which is inside a hidden .anaconda folder your Home directory.

    Hidden files and folders are not visible in file browsers under normal circumstances. For help viewing hidden files on:

    For more information on viewing hidden files and folders in Windows, see View hidden files and folders in Windows in Microsoft’s documentation.

    To view hidden files on macOS, use Shift+Cmd+. in your Finder.

    To view hidden files on Linux, use Alt+. or Ctrl+H (depending on your file manager).

  2. Make and save your changes.

  3. Close and reopen Navigator or any Anaconda Prompt or command line windows.