Installation guide¶
Before installing django-registration, you’ll need to have a copy of Django already installed. For information on obtaining and installing Django, consult the Django download page, which offers convenient packaged downloads and installation instructions.
The 2.0 release of django-registration supports Django 1.7, 1.8 and 1.9, on any Python version supported by those versions of Django:
- Django 1.7 supports Python 2.7, 3.2, 3.3 and 3.4.
- Django 1.8 suports Python 2.7, 3.2, 3.3, 3.4 and 3.5.
- Django 1.9 supports Python 2.7, 3.4 and 3.5.
Important
Python 3.2
Although Django 1.7 and 1.8 support Python 3.2, and django-registration 2.0 supports it, many Python libraries supporting Python 3 impose a minimum requirement of Python 3.3 (due to conveniences added in Python 3.3 which make supporting Python 2 and 3 in the same codebase much simpler).
As a result, use of Python 3.2 is discouraged; Django 1.9 has already dropped support for it, and a future release of django-registration will likely drop Python 3.2 support as well.
Normal installation¶
The preferred method of installing django-registration is via pip, the standard Python package-installation tool. If you don’t have pip, instructions are available for how to obtain and install it. If you’re using Python 2.7.9 or later (for Python 2) or Python 3.4 or later (for Python 3), pip came bundled with your installation of Python.
Once you have pip, simply type:
pip install django-registration
Manual installation¶
It’s also possible to install django-registration manually. To do so, obtain the latest packaged version from the listing on the Python Package Index. Unpack the .tar.gz file, and run:
python setup.py install
Once you’ve installed django-registration, you can verify successful installation by opening a Python interpreter and typing import registration.
If the installation was successful, you’ll simply get a fresh Python prompt. If you instead see an ImportError, check the configuration of your install tools and your Python import path to ensure django-registration installed into a location Python can import from.
Installing from a source checkout¶
The development repository for django-registration is at <https://github.com/ubernostrum/django-registration>. Presuming you have git installed, you can obtain a copy of the repository by typing:
git clone https://github.com/ubernostrum/django-registration.git
From there, you can use normal git commands to check out the specific revision you want, and install it using python setup.py install.
Next steps¶
To get up and running quickly, checkout the quick start guide. For full documentation, see the documentation index.