Skip to content
Tutorial Reference

How to Resolve Python Pip Error "EnvironmentError: [WinError 5] Access is denied"

Fix the Windows 'Access is denied' error when running pip install by using virtual environments, the --user flag, or checking for file locks.

When installing Python packages on Windows using pip, you may encounter the EnvironmentError: [WinError 5] Access is denied. This specific Windows error indicates that the operating system prevented pip from creating, modifying, or deleting files in the target installation directory due to insufficient user permissions or file locking.

This guide explains the common causes of this permission error on Windows and provides effective solutions, including using virtual environments and the --user flag.

Understanding the Error: Windows Permissions and Pip

Windows operating systems have a permission system that controls which users can read, write, or modify files and folders. Python packages, when installed globally, typically reside in a site-packages directory under the main Python installation folder (e.g., C:\Program Files\Python310\Lib\site-packages or similar). Standard user accounts often lack the necessary write permissions for these system-level directories.

The [WinError 5] Access is denied error occurs when pip attempts to perform a file operation (like creating a package folder or writing files) inside one of these protected directories, but your current user account doesn't have the required administrative privileges. Additionally, Windows can lock files that are currently in use by another process, also resulting in an access denied error during installation or upgrade attempts.

Common Causes for [WinError 5]

  • Installing Globally Without Administrator Privileges: Trying to pip install <package> directly into the main system Python installation without running the Command Prompt or PowerShell as an administrator.
  • File Locking by Running Processes: Attempting to install or upgrade a package while another Python script, IDE (like PyCharm, VS Code), or application is actively using files from that package or the target installation directory.
  • Incorrect Directory Permissions: Less commonly, the permissions on the Python installation folder or the specific site-packages directory might have been inadvertently changed, preventing even administrators from writing to it without explicit adjustments.

This is the standard best practice for Python development and the most effective way to avoid permission errors. Virtual environments create isolated project directories where packages are installed locally, requiring only standard user permissions.

  1. Open Command Prompt (cmd) or PowerShell in your project's chosen parent directory.
  2. Create the virtual environment: 
    python -m venv venv # 'venv' is the conventional folder name
  3. Activate the environment: 
    :: Windows Command Prompt (cmd.exe)
venv\Scripts\activate.bat

venv\Scripts\Activate.ps1
    Your command prompt should now show (venv) at the beginning.
  4. Install packages within the active environment: 
    pip install <package-name> # e.g., pip install requests

Packages are installed inside the venv folder in your project, completely avoiding system-wide permission issues.

Solution 2: Install to User Site-Packages (--user)

This flag tells pip to install the package in a location within your user profile (%APPDATA%\Python\PythonXY\site-packages), where you typically have write permissions, rather than the global site-packages.

pip install <package-name> --user
py -m pip install <package-name> --user
  • Use Case: Suitable for tools you want available generally for your user account without affecting the system Python or needing admin rights.
  • Drawback: Doesn't provide project isolation like virtual environments. Cannot be used inside an active virtual environment (pip will likely ignore it or error).

Solution 3: Run as Administrator (Use with Caution)

You can grant pip the necessary permissions by running your terminal (Command Prompt or PowerShell) with administrator privileges.

  1. Search for cmd or PowerShell in the Windows search bar.
  2. Right-click the application icon.
  3. Select "Run as administrator".
  4. Accept the User Account Control (UAC) prompt.
  5. In the administrator terminal, run the standard pip install command: 
    pip install <package-name>

Solution 4: Check for Running Python Processes (File Locking)

If the error occurs during an upgrade or reinstallation of a package, Windows might deny access because files belonging to the package are currently being used.

  • Close Applications: Shut down any running Python scripts, IDEs (VS Code, PyCharm, Spyder), Jupyter notebooks, or other applications that might be using the package you're trying to modify.
  • Check Task Manager: Open Task Manager (Ctrl+Shift+Esc) and look for running python.exe or pythonw.exe processes that you can safely terminate.
  • Restart: As a last resort for file locking, restarting your computer will ensure all file handles are released. Try the pip install command again immediately after restarting.

Solution 5: Adjust Directory Permissions (Advanced/Risky)

Manually changing permissions on system folders is generally not recommended unless you fully understand the implications. If you installed Python to a custom location or suspect permissions were damaged, you could try adjusting them.

  1. Find Python Installation: Use where python in cmd or python -c "import sys; print(sys.prefix)" to find the base directory. Navigate to the Lib\site-packages subdirectory within it.
  2. Modify Permissions: Right-click the site-packages folder -> Properties -> Security Tab -> Edit... -> Select your user account (or the 'Users' group) -> Check the "Allow" box for "Full control" (or at least "Modify"). -> Apply / OK.

Solution 6: Upgrade pip and setuptools

While less likely to be the direct cause of WinError 5, ensuring pip and setuptools are up-to-date is good practice and can sometimes resolve underlying installation bugs.

python -m pip install --upgrade pip setuptools wheel

Conclusion

The EnvironmentError: [WinError 5] Access is denied during pip install on Windows almost always relates to permissions or file locking.

The recommended solutions are:

  1. Use Virtual Environments: Create and activate a venv for your project before installing packages (python -m venv venv, activate, pip install ...). This is the best practice.
  2. Use the --user Flag: Install packages specifically for your user account (pip install <package-name> --user), avoiding the need for system-wide permissions.
  3. Check for File Locks: Close running Python applications or IDEs that might be using the package files, or restart your computer.
  4. Run as Administrator: Use only if absolutely necessary for global installation and if you understand the risks.
  5. Fix Directory Permissions: As a last resort for non-standard setups or damaged permissions.

By managing permissions effectively, primarily through virtual environments, you can reliably avoid the [WinError 5] error.

Navigation