Getting started

Installation

Install the entitled Authkits Django wheel into an existing project, keep your current user model and infrastructure, and mount the packaged authentication routes.

Python 3.10–3.14

Use a Python version supported by your selected Django release.

Django 5.2 or 6.0

Authkits is tested against the supported Django matrix.

No Redis or Celery required

The base package uses Django, cryptography, and packaging.

Install the customer wheel

Terminal

$python -m pip install ./authkits_django-<version>-py3-none-any.whl

Optional integrations are explicit. Install authkits-django[social], authkits-django[api], or both when your project needs them.

Add the Django app

settings.py

INSTALLED_APPS = [
    # Django apps...
    "authkits",
]

Authkits respects your existing AUTH_USER_MODEL. You do not need to replace it with an Authkits-specific user model.

Mount the routes

urls.py

from django.urls import include, path

urlpatterns = [
    path("auth/", include("authkits.urls")),
]

Migrate and verify

Terminal

$python manage.py migrate$python manage.py check$python manage.py collectstatic

Authkits ships overrideable templates and static assets. There is no required frontend build step.

Customize Authkits templates

Optional session tracking

To enable server-side session inventory and remote revocation, turn on SECURITY.SESSION_TRACKING and place authkits.security.middleware.SessionSecurityMiddlewareafter Django's AuthenticationMiddleware.

Next steps

Configure account policy, MFA, sessions, social providers, APIs, and licensing.

Configuration