Could not install packages due to an EnvironmentError: [WinError 5] Access is denied

avatar
Borislav Hadzhiev

Last updated: Apr 9, 2024
5 min

banner

# Could not install packages due to an EnvironmentError: [WinError 5] Access is denied

The error "Could not install packages due to an EnvironmentError: [WinError 5] Access is denied" occurs when we don't have the necessary permissions to install a package.

To solve the error, run the command with the --user option, e.g. pip install tensorflow-gpu --user.

shell
ERROR: Could not install packages due to an EnvironmentError: [WinError 5] Access is denied: 'C:\\Users\\bobbyhadz\\AppData\\Roaming\\Python\\Python310\\site-packages\\Python\\Python310\\site-packages' Consider using the `--user` option or check the permissions.

# Install the package with the --user option

One way to solve the error is to run the pip install command with the --user option.

shell
pip install <package-name> --user pip3 install <package-name> --user python -m pip install <package-name> --user python3 -m pip install <package-name> --user

install package with user option

Make sure to replace the <package-name> placeholder with the actual name of the package, e.g. pip install tensorflow-gpu --user.

shell
# ๐Ÿ‘‡๏ธ Install the correct pacakge with the --user option pip install tensorflow-gpu --user pip3 install tensorflow-gpu --user python -m pip install tensorflow-gpu --user python3 -m pip install tensorflow-gpu --user # ๐Ÿ‘‡๏ธ On Windows py -m pip install tensorflow-gpu --user

The --user option installs the package in the user's home directory.

The command basically installs the package scoped to the specific user, not for the entire system. This helps with permission issues.

However, the --user option wouldn't work if you have a virtual environment active.

# Upgrade your version of pip before installing the package

Another thing that often solves the error is upgrading your pip version before installing the specific package.

shell
python -m pip install --user --upgrade pip python -m pip install tensorflow-gpu python3 -m pip install --user --upgrade pip python3 -m pip install tensorflow-gpu # ๐Ÿ‘‡๏ธ on Windows py -m pip install --user --upgrade pip py -m pip install tensorflow-gpu

# Make sure you don't have any Python scripts running in the background

Make sure to stop all of your Python applications before running the installation command.

For example, if you try to upgrade the tensorflow package while you have an application running tensorflow in the background, the error is raised.

You have to stop your script and rerun the installation command.

If that didn't help, run CMD as an administrator and install the package.

# Run CMD as an administrator

To run CMD as an administrator:

  1. Click on the search bar and type "cmd".
  2. Right-click on "Command Prompt".
  3. Click on "Run as administrator".

windows run cmd as administrator

  1. Once you open the shell as an administrator, rerun the pip install command.
shell
pip install <package-name> pip3 install <package-name> python -m pip install <package-name> python3 -m pip install <package-name>
If you use PyCharm, close the IDE, right-click on it and open PyCharm as an administrator and then run the pip install command.

If opening CMD as an administrator didn't help, try to open PowerShell as an administrator and run the command.

To run PowerShell as an administrator:

  1. Click on the search bar and type "PowerShell".
  2. Right-click on "Windows PowerShell".
  3. Click on "Run as administrator".

windows run powershell as administrator

Another common cause of the error is having other Python scripts running in the background when running the pip install command.

Windows throws [WinError 5] Access is denied when the file is locked by another process.

If the error persists, change the user's access permissions.

# Change the user's access permissions

The error is often caused because the user doesn't have access to modify the directory where the package should be installed.

To solve the error, allow the user full access to the Python directory.

To change the access permissions for the user:

  1. Open the folder where you installed Python e.g. C:\Program Files (x86)\Python310.

You can find where Python is installed with either of the following 2 commands.

shell
where python python -c "import os, sys; print(os.path.dirname(sys.executable))"
  1. Once you open the directory where Python is installed, right-click on the "Python" or "Python310" folder and click "Properties".

rightclick properties

  1. Go to the "Security" tab and click on the "Edit" button.

click security tab and edit

  1. Allow "Full control" to your user or the entire "Users" group.

allow full control to users

  1. Click on "Apply".
  2. Run the pip install <package-name> command again.

Once you give "Full access" permissions to the user, you should be able to pip install packages without getting any errors.

If you have a virtual environment active, your Python location will be scoped to the specific virtual environment.

In other words, you have to edit the permissions for the user for a Python folder that's located in your project.

You can run the where python command with your virtual environment active to find the directory.

# Upgrade your version of pip and setuptools

If that didn't resolve the error, try upgrading your version of pip.

shell
# ๐Ÿ‘‡๏ธ If you have pip already installed pip install --upgrade pip # ๐Ÿ‘‡๏ธ If your pip is aliased as pip3 (Python 3) pip3 install --upgrade pip # ๐Ÿ‘‡๏ธ If you don't have pip in your PATH environment variable python -m pip install --upgrade pip # ๐Ÿ‘‡๏ธ If you don't have pip in your PATH environment variable python3 -m pip install --upgrade pip # ๐Ÿ‘‡๏ธ If you have easy_install easy_install --upgrade pip

If you get the error "ModuleNotFoundError: No module named 'pip' in Python", check out my other article:

If the commands from the code sample didn't work for you, click on the "Install pip in Python" link.

After you upgrade pip, upgrade setuptools as well.

shell
pip install --upgrade setuptools pip3 install --upgrade setuptools python -m pip install --upgrade setuptools python3 -m pip install --upgrade setuptools

The is often solved by upgrading your pip version and re-running the pip install command.

# Create a virtual environment

If the error persists, try creating a virtual environment.

  1. Create a virtual environment.
  2. Activate the virtual environment.
  3. Run the pip install command with the virtual environment active.
shell
# ๐Ÿ‘‡๏ธ Use the correct version of Python when creating VENV python3 -m venv venv # ๐Ÿ‘‡๏ธ Activate on Unix or MacOS source venv/bin/activate # ๐Ÿ‘‡๏ธ Activate on Windows (cmd.exe) venv\Scripts\activate.bat # ๐Ÿ‘‡๏ธ Activate on Windows (PowerShell) venv\Scripts\Activate.ps1 # ๐Ÿ‘‡๏ธ Install the specific package in the virtual environment pip install numpy

Make sure to use the correct command to activate your virtual environment depending on your operating system and your shell.

Your virtual environment will use the version of Python that was used to create it.

Make sure to not create your virtual environment as root, e.g. with sudo because then you'd only permit root users to install packages.

If you created your virtual environment using sudo, try changing its permissions or recreate it without sudo.

shell
sudo chmod -R 777 venv

The command above assumes that your virtual environment is in a folder called venv.

777 means granting all users full access to the contents of the directory.

# Set "include-system-site-packages" to "true"

If you use a virtual environment, another thing that might help is to:

  1. Open your venv folder.
  2. Click on the pyvenv.cfg file.
  3. Set the include-system-site-packages property to true.
  4. Save the file.
  5. Rerun the pip install command.

include system site packages

# Restart your PC

If nothing else helped, try to restart your PC and rerun the installation command.

This might help because the package you are trying to install/upgrade might be locked by another process.

Closing the process might enable you to run the installation command.

# Conclusion

The solve the "Could not install packages due to an EnvironmentError: [WinError 5] Access is denied" error:

  1. Run the pip install command with the --user option.
  2. Run CMD as an administrator before installing the package.
  3. Grant the user full access to the Python directory.
I wrote a book in which I share everything I know about how to become a better, more efficient programmer.
book cover
You can use the search field on my Home Page to filter through all of my articles.

Copyright ยฉ 2024 Borislav Hadzhiev