Home › Python

ModuleNotFoundError: No module named 'django' (Python) — how to fix

Traceback (most recent call last):
  File "manage.py", line 11, in main
    from django.core.management import execute_from_command_line
ModuleNotFoundError: No module named 'django'

The above exception was the direct cause of the following exception:

ImportError: Couldn't import Django. Are you sure it's installed and available on your PYTHONPATH environment variable? Did you forget to activate a virtual environment?

Quick fix: Activate the project's venv (source .venv/bin/activate, Windows .venv\Scripts\activate) and run python -m pip install django or python -m pip install -r requirements.txt. Then run python manage.py runserver with that interpreter. In production point gunicorn/uwsgi/mod_wsgi at the venv.

What it means

manage.py tried to import Django and Python couldn't find it on sys.path. Django's manage.py catches that error and re-raises it as "Couldn't import Django... Did you forget to activate a virtual environment?" That hint is usually correct: the project's venv isn't active, so the system Python runs and has no Django.

python -c "import sys; print(sys.executable)"

If this doesn't print a path inside your project's venv, that's the problem.

Fix 1: activate the venv

# macOS / Linux
source .venv/bin/activate        # or venv/bin/activate, env/bin/activate
# Windows PowerShell
.venv\Scripts\Activate.ps1
# Windows cmd
.venv\Scripts\activate.bat

Then run python manage.py runserver. With pipenv use pipenv run python manage.py runserver. With poetry use poetry run python manage.py runserver. With uv use uv run manage.py runserver.

On PowerShell, if activation is blocked with "running scripts is disabled", run Set-ExecutionPolicy -Scope CurrentUser RemoteSigned once.

Fix 2: install Django (or the requirements)

python -m venv .venv && source .venv/bin/activate   # if there is no venv yet
python -m pip install -r requirements.txt           # existing project
python -m pip install django                        # new project
python -m django --version

Use python -m pip so pip and Python match. Install outside a venv on Debian/Ubuntu and you get externally-managed-environment.

Fix 3: the venv was moved or Python was upgraded

A venv stores absolute paths. If you renamed the project folder, copied it to another machine, or upgraded Python (e.g. Homebrew 3.12 → 3.13), the venv's python may point at nothing or at an interpreter without Django. Recreate it:

rm -rf .venv
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -r requirements.txt

Never commit the venv folder to git. Commit requirements.txt instead (python -m pip freeze > requirements.txt).

Fix 4: the IDE uses another interpreter

Fix 5: production servers

The web server doesn't activate your venv:

Last updated 2026-11-15.