Installation

Requirements

Dependency	Version
Python	3.11+
Django	4.2, 5.2, 6.0

All three major databases are supported and tested in CI:

Database	Notes
PostgreSQL	Full support — recommended for production
MySQL / MariaDB	Full support
SQLite	Full support — used in development and tests

pip install django-migration-audit

# settings.py
INSTALLED_APPS = [
    # ...
    "django_migration_audit",
]

That's it. You can now run:

python manage.py audit_migrations

To have the audit run automatically every time manage.py migrate completes, add AUTO_RUN to your settings:

# settings.py
MIGRATION_AUDIT = {
    "AUTO_RUN": True,
}