How to upgrade django?

Question

My project was running on Django 1.5.4 and I wanted to upgrade it. I did pip install -U -I django and now pip freeze shows Django 1.6.5 (clearly django

Answer 1

pip install --upgrade django

works just fine, but before upgrading it's highly recommended to read this part from the documentation: https://docs.djangoproject.com/en/2.1/howto/upgrade-version/

Answer 2

The method outlined in the docs is correct -
https://docs.djangoproject.com/en/3.0/howto/upgrade-version/

What I can add to the above answers is the rationale. If you're very far behind in Django versions (ex. 1.5 -> and you want to go to 2.0) the developers only want you to upgrade one step at a time. ex. 1.5 -> 1.6 -> 1.7 etc.

The purpose being that this limits the amount of things that break on upgrading. You should include the -Wa warning flags every time you upgrade a step, so you can fix deprecated features before they are removed in future upgrades.

A feature is generally deprecated for a couple of versions, and then removed entirely. So this gives you the ability to keep the app stable while upgrading.

Answer 3

You can use the upgraded version after upgrading.

You should check that all your tests pass before deploying :-)