Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

django-snapshots

License: MIT Ruff PyPI version PyPI pyversions PyPI djversions PyPI status Documentation Status Code Cov Test Status Lint Status OpenSSF Scorecard

A generic and pluggable backup and restore management utility for Django.

Back up your databases, MEDIA_ROOT and Python environment into a single, checksummed snapshot, and restore it with one command.

This is a beta release. The CLI and settings are stabilizing but may still change before 1.0.

Features

  • Native, consistent dumps for SQLite, PostgreSQL and MySQL/MariaDB, with a dumpdata fallback for any other backend.
  • Snapshots stored as a directory or as a single .tar archive, on the local filesystem or any Django storage backend.
  • SHA-256 checksums for every artifact, all verified before any data is restored.
  • Retention policies (keep, duration, max_size) for pruning old snapshots.
  • A read-only Django admin page for browsing the snapshots in storage.
  • Pluggable: add your own artifact types, database connectors and storage backends.

Installation

pip install django-snapshots
INSTALLED_APPS = [
    ...
    "django_snapshots",
    "django_snapshots.backup",
    "django_snapshots.restore",
]

# optional, snapshots go to ./snapshots by default
SNAPSHOTS = {
    "STORAGE": {
        "BACKEND": "django_snapshots.storage.LocalFileSystemBackend",
        "OPTIONS": {"location": "/var/backups/snapshots"},
    },
}

Then run python manage.py migrate (django-snapshots adds one always-empty table that backs its admin page and permission).

Usage

python manage.py snapshots backup                       # databases + media + environment
python manage.py snapshots backup --name pre-deploy database
python manage.py snapshots list
python manage.py snapshots restore --name pre-deploy    # or omit --name for the latest
python manage.py snapshots prune --keep 10

Documentation

Full documentation is available at django-snapshots.readthedocs.io.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md.

Metadata

Release files for django-snapshots 0.1.0b1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for django-snapshots 0.1.0b1
File Size Uploaded Provenance Actions
django_snapshots-0.1.0b1.tar.gz 501.9 kB With provenance Details for django_snapshots-0.1.0b1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for django-snapshots 0.1.0b1
File Interpreter ABI Platform Actions
django_snapshots-0.1.0b1-py3-none-any.whl Python 3 none any Details for django_snapshots-0.1.0b1-py3-none-any.whl

Total release size: 561.1 kB

Release files / django_snapshots-0.1.0b1.tar.gz

Download URL django_snapshots-0.1.0b1.tar.gz
Size 501.9 kB
Tags Source
SHA-256 checksum
How to use checksums
fca04e04dfac64e2137059880d4f1bc9ee4f46227255708855f77dd221f3fa23
BLAKE2b-256 checksum
How to use checksums
39c5923f635cca450bee5511ef23cb608e89cd6b28edf806191ca0c978180a8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / django_snapshots-0.1.0b1-py3-none-any.whl

Download URL django_snapshots-0.1.0b1-py3-none-any.whl
Size 59.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1e2ea52cd263ce59ce5cf37b2e084a5a5f54951e7b08a749e79e5ded12775a9d
BLAKE2b-256 checksum
How to use checksums
30cba23dcf4388c2266fc55804c68e57ba0281fc3e129e5103bedbca160f9a60
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Security for django-snapshots 0.1.0b1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for django_snapshots-0.1.0b1.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page