617

I have a conda environment named old_name, how can I change its name to new_name without breaking references?

2
  • See also this post on how to clone a conda environment
    – pylang
    Commented Nov 22, 2019 at 16:43
  • 19
    you can't rename (frustrating!) but you can clone the old env with the new name and delete the old env: conda create --name new_name --clone old_name then delete old one: conda remove --name old_name --all Commented Sep 28, 2020 at 20:00

10 Answers 10

980

New answer:

From Conda 4.14 you will be able to use just:

conda rename -n old_name  new_name 

Although, under the hood, conda rename still uses [1][2] undermentioned combination of conda create and conda remove.

Use the -d flag for dry-run (not destination, as of v22.11.0)

conda rename -n old_name -d new_name 

Old answer:

You can't.

One workaround is to create clone a new environment and then remove the original one.

First, remember to deactivate your current environment. You can do this with the commands:

  • deactivate on Windows or
  • source deactivate on macOS/Linux.

Then:

conda create --name new_name --clone old_name
conda remove --name old_name --all # or its alias: `conda env remove --name old_name`

Notice there are several drawbacks of this method:

  1. It redownloads packages (you can use --offline flag to disable it)
  2. Time consumed on copying environment's files
  3. Temporary double disk usage

There is an open issue requesting this feature.

18
  • 12
    so as to leave some work for those who fork conda and thereby making them understand much more en route :P :D Commented Jul 3, 2017 at 6:40
  • 2
    @silgon Well, it's not my solution (but it's relatively obvious one). I just gathered this information on SO for better searchability - the github issue thread didn't showed up in google searches.
    – pkowalczyk
    Commented Jul 14, 2017 at 0:16
  • 5
    Another way is to clone the environment conda create --name new_name --clone old_name then you can remove the old one.
    – tupui
    Commented Nov 22, 2017 at 14:01
  • 9
    Word of warning - I tried doing this, and ran into bizarre errors - my .bashrc no longer worked, and trying to run pytest would fail, trying to reference the now-removed environment. I tried new shells and restarting with no luck. Ended up having to blow away the new environment, then just start with a clean install. Slower, but seems to actually work now.
    – dwanderson
    Commented Feb 27, 2018 at 18:09
  • 6
    @dwanderson +5000 as I was going to try using this answer but instead I'm just going to pull the bandaid right off and recreate my badly named env from scratch.
    – bgoodr
    Commented Feb 2, 2019 at 20:44
46

conda create --name new_name --copy --clone old_name is better

I use conda create --name new_name --clone old_name which is without --copy but encountered pip breaks...

the following url may help Installing tensorflow in cloned conda environment breaks conda environment it was cloned from

2
  • 1
    mvenv () { conda create --name $2 --copy --clone $1 ; conda remove --name $1 --all ;}
    – user3673
    Commented Sep 20, 2020 at 4:32
  • (Put that at the end of ~/.bashrc and you apparently have the requested feature. Feel free to incorporate it in your answer since I couldn't have conceived of your solution involving both --clone and --copy.)
    – user3673
    Commented Sep 20, 2020 at 4:34
19

conda should have given us a simple tool like cond env rename <old> <new> but it hasn't. Simply renaming the directory, as in this previous answer breaks the hardcoded hashbangs(#!). Hence, we need to go one more level deeper to get what we want.

conda env list
# conda environments:
#
base                  *  /home/tgowda/miniconda3
rtg                      /home/tgowda/miniconda3/envs/rtg

Here I am trying to rename rtg --> unsup (please bear with those names, this is my real use case)

$ cd /home/tgowda/miniconda3/envs 
$ OLD=rtg
$ NEW=unsup
$ mv $OLD $NEW   # rename dir

$ conda env list
# conda environments:
#
base                  *  /home/tgowda/miniconda3
unsup                    /home/tgowda/miniconda3/envs/unsup


$ conda activate $NEW
$ which python
  /home/tgowda/miniconda3/envs/unsup/bin/python

the previous answer reported upto this, but wait, we are not done yet! the pending task is, $NEW/bin dir has a bunch of executable scripts with hashbangs (#!) pointing to the $OLD env paths.

See jupyter, for example:

$ which jupyter
/home/tgowda/miniconda3/envs/unsup/bin/jupyter

$ head -1 $(which jupyter) # its hashbang is still looking at old
#!/home/tgowda/miniconda3/envs/rtg/bin/python

So, we can easily fix it with a sed

$ sed  -i.bak "s:envs/$OLD/bin:envs/$NEW/bin:" $NEW/bin/*  
# `-i.bak` created backups, to be safe

$ head -1 $(which jupyter) # check if updated
#!/home/tgowda/miniconda3/envs/unsup/bin/python
$ jupyter --version # check if it works
jupyter core     : 4.6.3
jupyter-notebook : 6.0.3

$ rm $NEW/bin/*.bak  # remove backups

Now we are done 💯

I think it should be trivial to write a portable script to do all those and bind it to conda env rename old new.


I tested this on ubuntu. For whatever unforseen reasons, if things break and you wish to revert the above changes:

$ mv $NEW  $OLD
$ sed  -i.bak "s:envs/$NEW/bin:envs/$OLD/bin:" $OLD/bin/*
3
  • 9
    If trivial it would be great for you to contribute this to the code base! Many would appreciate it (myself included)
    – Shawn
    Commented Aug 29, 2020 at 21:44
  • The sed -i '' "s/old/new" $NEW/bin/* will encounter "not a regular file" error, for me. To replace all the sheband lines in all regular files, I have to use: $ find $NEW/bin/* -maxdepth 1 -type f -exec sed -i.bak "s:envs/$OLD/bin:envs/$NEW/bin:" {} \; to escape the non-regular files.
    – Sam Tseng
    Commented Mar 9, 2022 at 16:23
  • What about binary libraries that are relocated using rpath? It isn't simple to relocate conda environments because there is so much magic behind the scenes to make it work like an isolated environment. Commented Jun 10, 2022 at 19:06
15

Based upon dwanderson's helpful comment, I was able to do this in a Bash one-liner:

conda create --name envpython2 --file <(conda list -n env1 -e )

My badly named env was "env1" and the new one I wish to clone from it is "envpython2".

1
  • 4
    Ran into an error saying PackagesNotFoundError: The following packages are not available from current channels with this script. This script probably works only when you don't have packages that are installed with pip and that are not available in conda in the existing environment?
    – Ethan Chen
    Commented Apr 2, 2020 at 16:42
9

Update: You can now officially rename a conda environment, but THIS IS SLOWER

conda rename -n old_env_name new_env_name

This command clone the new environment and performs downloading and installation

Logs:

❯ conda rename -n a b
Source:      /home/long/work/miniconda3/envs/a
Destination: /home/long/work/miniconda3/envs/b
Packages: 20
Files: 61608

Downloading and Extracting Packages:


Downloading and Extracting Packages:

Preparing transaction: done
Verifying transaction: done
Executing transaction: done

TRY THIS, IT'S FASTER & SAFER

As the answer from @pkowalczyk mentioned some drawbacks: In my humble opinion, the painless and risk-free (workaround) way is following these steps instead:

  1. Activate & Export your current environment conda env export > environment.yml
  2. Deactivate current conda environment. Modify the environment.yml file and change the name of the environment as you like (or check step 3 for --name argument), also you may want to change (delete is better) the prefix line as well.
  3. Create a new conda environment by executing this conda env create -f environment.yml. Note that if you want to change the name of the new environment you plan to create, add --name new_env_name to the previous command, it becomes
conda env create --name new_env_name -f environment.yml

I suggest an even safer way, that is using conda update

conda env update --name your_env_name --file environment.yml --prune

This process takes a couple of minutes, and now you can safely delete the old environment.

Logs:

❯ conda env export > environment.yml
❯ conda deactivate 
❯ conda env create --name b -f environment.yml
Retrieving notices: ...working... done
Channels:
 - defaults
Platform: linux-64
Collecting package metadata (repodata.json): done
Solving environment: done

Downloading and Extracting Packages:

Preparing transaction: done
Verifying transaction: done
Executing transaction: done
5
  • I'm liking this answer, and in the middle of executing it. I believe, though, that the prefix: ... line should also be changed to the new name, so the env folder isn't re-used...? Commented Apr 4, 2022 at 0:04
  • ** UPDATE ** - changing the prefix in environment.yml was NOT honored. But adding the -p option worked fine: conda env create -f environment.yml -p /path/to/env Commented Apr 4, 2022 at 2:56
  • You don't have to change anything, instead, you provide --name while creating new environment. Note that your environment file should end with .yml, not .txt.
    – Long
    Commented Apr 14, 2022 at 7:07
  • Make sure that you change both the first line (name: <new name> ) and the final line (prefix: /dir1/dir2/../dirn/<new name>).
    – Ottpocket
    Commented Jun 17, 2022 at 14:50
  • Just updated my answer to discuss the new rename command. Which is still slower than the workaround solution.
    – Long
    Commented Aug 2 at 8:20
7

I'm using Conda on Windows and this answer did not work for me. But I can suggest another solution:

  • rename enviroment folder (old_name to new_name)

  • open shell and activate env with custom folder:

    conda.bat activate "C:\Users\USER_NAME\Miniconda3\envs\new_name"

  • now you can use this enviroment, but it's not on the enviroment list. Update\install\remove any package to fix it. For example, update numpy:

    conda update numpy

  • after applying any action to package, the environment will show in env list. To check this, type:

    conda env list

1
  • Worked. Immediately showed in conda env list. Thanks.
    – BSalita
    Commented Aug 9, 2021 at 10:10
5

Simply rename the environment's folder

This was the easiest solution to rename a conda environment on Windows. It likely works on Mac too (just haven't tested it). I just renamed my old environment directory and it worked:

mv ~/anaconda3/envs/old_name ~/anaconda3/envs/new_name

Source: https://github.com/conda/conda/issues/3097#issuecomment-314527753

4

For that one can access the base/root environment and use conda rename.

Assuming one's environment is stack and one wants the name lab, one can do the following

conda rename -n stack lab

Other alternatives include

conda rename --name stack lab

conda rename -p path/to/stack lab

conda rename --prefix path/to/stack lab

Notes:

  • One cannot rename the base environment.

  • One cannot rename an active environment. If one is in the prompt of the environment stack one won't be able to do the operations above, and it will give a CondaEnvException

CondaEnvException: Cannot rename the active environment

  • If one tries to rename using an existing environment name, one will get a CondaEnvException. Using the case above, one will get

CondaEnvException: The environment 'lab' already exists. Override with --force.

0
2

According to the answer of Thamme Gowda, the following steps work for me on my MacBook Pro:

  1. Change the folder name of the old env name into a new env name.
  2. Replace all the old env name in the shebang lines of all regular files under the bin folder in the new env folder.

The commands are:

$ conda deactivate
$ OLD=old_name
$ NEW=new_name
$ cd /Users/my_username/anaconda3/envs/
$ mv $OLD $NEW
$ find $NEW/bin/* -maxdepth 1 -type f -exec sed  -i.bak "s:envs/$OLD/bin:envs/$NEW/bin:" {} \;
$ conda activate new_name

Check if the shebang line is correctly replaced:

$ head -1 $(which jupyter) #!/Users/my_username/anaconda3/envs/new_name/bin/python

-1

You can rename your Conda env by just renaming the env folder. Here is the proof:

Conda env renaming

You can find your Conda env folder inside of C:\ProgramData\Anaconda3\envs or you can enter conda env list to see the list of conda envs and its location.

4
  • 4
    That is not true for Linux
    – ottovon
    Commented Sep 15, 2020 at 11:28
  • 7
    Bad idea: stackoverflow.com/a/52717925/1506477 explains why Commented Dec 4, 2020 at 5:34
  • recipe for disaster, don't do that!
    – PatrickT
    Commented Feb 11, 2022 at 17:59
  • this does seem to work on linux and the "Bad idea" link leads to an answer to the current question that never actually mentions why this is a bad idea except for one comment that says that conda stores some hard-coded paths (which does answer it, but is not very specific - which paths precisely? maybe it's something that can be ignored?). Commented Jun 28, 2022 at 15:09

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.