Installation

django-registration 5.2.1 supports Django 4.2, 5.1, and 5.2, and Python 3.9 through 3.13. See Django’s Python support matrix for details of which Python versions are compatible with each version of Django.

Installing django-registration

To install django-registration, run the following command from a command prompt/terminal:

python -m pip install django-registration
py -m pip install django-registration

This will use pip, the standard Python package-installation tool. If you are using a supported version of Python, your installation of Python should have come with pip bundled. If pip does not appear to be present, you can try running the following from a command prompt/terminal:

python -m ensurepip --upgrade
py -m ensurepip --upgrade

Instructions are also available for how to obtain and manually install or upgrade pip.

If you don’t already have a supported version of Django installed, using pip to install django-registration will also install the latest supported version of Django.

Installing for local development

If you want to work on django-registration, you can obtain a source checkout.

The development repository for django-registration is at <https://github.com/ubernostrum/django-registration>. If you have git installed, you can obtain a copy of the repository by typing:

git clone https://github.com/ubernostrum/django-registration.git

Then follow the instructions in the file CONTRIBUTING.rst in the root directory of the source checkout.

Next steps

To get up and running quickly, check out the quick start guide. For full documentation, see the documentation index.