Nibesh Khadka
Khadka's Coding Lounge


Khadka's Coding Lounge

How to set up a Virtual Environment and Virtual Environment Wrapper on Ubuntu 20?

How to set up a Virtual Environment and Virtual Environment Wrapper on Ubuntu 20?

Easy steps to install virtual environment with virtual environment wrapper in Linux OS.

Nibesh Khadka's photo
Nibesh Khadka
·Feb 1, 2022·

2 min read

Play this article

Table of contents

  • Pre-requisite
  • Install Virtual Environment Wrapper
  • WorkOn command not found

Virtual Environment Wrapper is a management tool for virtual environments. It is easy to access, create and delete virtual environments using a virtual environment wrapper. The objective of this blog is to help my fellow readers, set up a Virtual Environment Wrapper in Linux OS.


To follow along with the blog, you're gonna need pip installed in your system. If you haven't, then you can read my blog about creating a virtual environment.

Install Virtual Environment Wrapper

  1. Open command terminal:
 pip install virtualenvwrapper
  1. Make a directory for storing virtual environments.
mkdir ~/.virtualenvs
  1. Set the directory as the go-to directory for the wrapper.
export WORKON_HOME=~/.virtualenvs
  1. Provide a Virtual Environment Wrapper path to your python installation.
  1. Provide the path to the wrapper for the start-up shell
source /usr/local/bin/
  1. Create a virtual environment
mkvirtualenv yourEnvName

This command will create as well as activate your environment at once. You'll probably see two environments, your base environment, and the newly created environment.

  1. Deactivate the virtual environment with:
  1. Check the list of environments in your wrapper with:

9.Switch the environments with:

workon envronment_name

WorkOn command not found

Now, when you close the terminal and then restart it, and then type "workon", the terminal will not recognize workon command. It's because we have yet to add the settings permanently in .bashrc and .bash_profile files.

1.On BashRc File

Open the bash file on nano editor.

nano ~/.bashrc

On BashRc file go to the end of the line (where doesn't matter, it's just to keep it simple) and add the following lines

#Virtual Env Wrapper settings
export WORKON_HOME=~/.virtualenvs
source /usr/local/bin/

Now, Press Ctrl+S to save the file and Ctrl+X to exit.

2.On Bash_Profile File

Open the file on nano editor.

nano ~/.bash_profile

Add the following towards the end.

# For Virtual Wrapper
source ~/.local/bin/

Now, Press Ctrl+S to save the file and Ctrl+X to exit.

After this, you're all set. Close and reopen the terminal and type workon, it'll list all the environments in your wrapper.

Thank you for reading. If this article helped you then please give it a like to show support. If you found any error while following the steps please mention it in the comment. Find my other blogs here.

Like, Share, Comment and Subscribe

Did you find this article valuable?

Support Nibesh Khadka by becoming a sponsor. Any amount is appreciated!

See recent sponsors Learn more about Hashnode Sponsors
Share this