Installez Vanta Admin dans votre projet Django

Ajoutez le package, placez le thème avant Django admin, collectez des ressources statiques et continuez à utiliser l’admin que vous connaissez déjà.

Paquet PyPI

Django admin

Paquet vanta-admin

Application Django vanta_admin

Plage du paquet Python 3.12+ / Django 6.0–6.1

1. Installer le paquet

Utilisez PyPI pour les projets habituels. Le nom du paquet est vanta-admin.

uv add vanta-admin

pip

pip install vanta-admin

2. Ajouter l’application Django

Ajoutez vanta_admin à INSTALLED_APPS avant django.contrib.admin. Cet ordre permet aux modèles admin de Vanta de définir les valeurs par défaut override Django.

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django.contrib.admin",
    # ...
]

3. Collecter les fichiers statiques

Exécutez la commande Django habituelle collectstatic avant le déploiement. Les fichiers CSS, JavaScript et favicon empaquetés seront ainsi disponibles dans votre configuration de fichiers statiques.

Projet uv

uv run python manage.py collectstatic

Python standard

python manage.py collectstatic

4. Mettre à jour Vanta Admin

Depuis la racine de votre projet, résolvez la dernière version de Vanta Admin et synchronisez l’environnement. Cela fonctionne avec la commande habituelle uv add vanta-admin.

uv lock --upgrade-package vanta-admin
uv sync

pip

pip install --upgrade vanta-admin

5. Conservez votre identité

Vanta stylise l’admin ; votre projet possède toujours le texte affiché dans l'onglet du navigateur, l'en-tête et l'index admin.

admin.py

from django.contrib import admin

admin.site.site_header = "Your Admin"
admin.site.site_title = "Your Admin"
admin.site.index_title = "Your Admin"

6. Modèles 2FA facultatifs

Si votre projet utilise déjà django-two-factor-auth, Vanta peut aussi mettre en forme ces écrans visibles. Il n’installe, n’active ni ne configure l’authentification à deux facteurs à votre place.

settings.py

INSTALLED_APPS = [
    "vanta_admin",
    "django_otp",
    "django_otp.plugins.otp_static",
    "django_otp.plugins.otp_totp",
    "two_factor",
    "django.contrib.admin",
    # ...
]

Vérifiez l’admin après l'installation

Démarrez votre projet Django, ouvrez l’admin et vérifiez l'écran de connexion, la barre latérale, les listes de modifications, les formulaires, les messages et la présentation mobile. Le thème reste rendu par le serveur et ne remplace pas le comportement, les autorisations, les URL ou les modèles de base de données de Django admin.

Voir le code source