How to Relocate Your Anaconda or Miniconda Installation on Linux

Sometimes you need to move your Anaconda or Miniconda installation to a different location on disk — maybe you’re out of space on one partition, reorganizing, or setting up a new machine. The catch is that conda hardcodes its install path in many places during setup, so moving the folder alone isn’t enough. This guide walks through doing it safely on Linux.

Understanding the task ahead

Relocating conda isn’t as simple as moving the installation directory. The environment configuration and paths hardcoded during installation must be updated correctly so the environment works after the move. Let’s break down the steps.

Step 1: Back up your environment

Before making any changes, back up your existing environment so you can restore it if anything goes wrong.

mkdir ~/conda-backup
cp -r ~/miniconda/* ~/conda-backup/

Note: Replace ~/miniconda with the path to your current Anaconda or Miniconda installation.

Step 2: Move the installation directory

Use mv to move your installation to a new directory. Ensure you have write permissions for the target.

mv /path/to/current/conda /new/path/to/conda

Here, /path/to/current/conda is your current installation path, and /new/path/to/conda is where you want to move it.

Step 3: Update environment variables

Update the PATH environment variable in your shell configuration file (.bashrc, .bash_profile, .zshrc, etc.) to reflect the new directory.

Edit your shell configuration file:

export PATH="/new/path/to/conda/bin:$PATH"

After modifying the file, apply the changes:

source ~/.bashrc  # Adjust this command based on your shell

Step 4: Correct hardcoded paths

Some configs and scripts have paths hardcoded to the old location. Update those references.

Navigate to your new Conda directory:

cd /new/path/to/conda

Use find and sed to update hardcoded paths:

find . -type f -exec sed -i 's|/path/to/current/conda|/new/path/to/conda|g' {} +

Adjust the paths as necessary for your situation.

Step 5: Verify the move

After relocating and updating your Conda installation, verify everything works:

conda activate
conda list

Try creating a new environment to further ensure functionality:

conda create --name testenv python=3.8

conda env export -n myenv > myenv.yml     # per environment
# ...reinstall conda at the new path, then:
conda env create -f myenv.yml

Recap

Without scrolling up — why is this more than a mv? Relocating conda means:

• Back up first (your safety net),
• Move the directory,
• Update PATH in your shell rc file,
• Fix hardcoded prefixes (or, more robustly, export and recreate environments / use conda-pack),
• Verify with conda activate and conda list.

The install path is baked in at setup time — respect that and the move goes smoothly. Happy computing!

Where to go next

• Managing conda environments — exporting and recreating environments.
• conda-pack — purpose-built environment relocation.
• Miniforge — the free, conda-forge-default installer.