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.

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

Navigator Preferences dialog

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

   Windows/Linux

   Open the File menu and click Preferences.

   macOS

   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.

For a list of all Navigator Preferences, see Navigator preferences.

Preferred text editor

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

Edit .condarc

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>/miniconda3/.condarc <==
   channels:
     - defaults
   

   The .condarc is a hidden file on macOS and Linux. View hidden files and folders using the following guidance for your operating system:

   macOS

   Use Shift+Cmd+. in your Finder.

   Linux

   Use Alt+. or Ctrl+H (depending on your file manager).

   ---

   For more information on the .condarc file, see Using the .condarc conda configuration file in the official conda documentation.

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.

Edit anaconda-navigator.ini

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 an .anaconda folder in your Home directory. This folder is hidden on macOS and Linux and is not visible in file browsers under normal circumstances.

   You can view hidden files and folders using the following guidance for your operating system:

   macOS

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

   Linux

   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.