A custom User model for everybody!
Clone or download
gavinwahl Merge pull request #94 from fundor333/patch-1
Fix the docs about the installation
Latest commit be6fedf May 14, 2018



Build Status

A custom user model app for Django 1.8+ that features email as username and other things. It tries to stay true to the built-in user model for the most part.

The main differences between authtools's User and django.contrib.auth's are email as username and class-based auth views.

Read the django-authtools documentation.


Before you use this, you should probably read the documentation about custom User models.

  1. Install the package:

    $ pip install django-authtools
  2. Add authtools to your INSTALLED_APPS.

  3. Add the following to your settings.py:

    AUTH_USER_MODEL = 'authtools.User'
  4. Add authtools.urls to your URL patterns:

    urlpatterns = patterns('',
        # ...
        url(r'^accounts/', include('authtools.urls')),
        # ...
  5. Enjoy.