# 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.