This backend is in the pre-alpha stage of development. Backwards incompatible changes may be made without notice. We welcome your feedback as we continue to explore and build.

Use the version of django-mongodb that corresponds to your version of Django. For example, to get the latest compatible release for Django 5.0.x:

pip install django-mongodb==5.0.*

The minor release number of Django doesn't correspond to the minor release number of django-mongodb. Use the latest minor release of each.

While django-mongodb only has pre-releases (alphas or betas), you'll see an error with a list of the available versions. In that case, include --pre to allow pip to install the latest pre-release.

For example, if django-mongodb 5.0 alpha 1 is the latest available version of the 5.0 release series:

$ pip install django-mongodb==5.0.* ERROR: Could not find a version that satisfies the requirement django-mongodb==5.0.* (from versions: ..., 5.0a1) $ pip install --pre django-mongodb==5.0.* ... Successfully installed ... django-mongodb-5.0a1 ... 

Configure the Django DATABASES setting similar to this:

DATABASES = { "default": { "ENGINE": "django_mongodb", "NAME": "my_database", "USER": "my_user", "PASSWORD": "my_password", }, }

• The following QuerySet methods aren't supported:

  • annotate()
  • aggregate()
  • dates()
  • datetimes()
  • distinct()
  • extra()
  • select_related()

• Queries with joins aren't supported.

• DateTimeField doesn't support microsecond precision.

TODO

This project began by borrowing code from Django non-rel's MongoDB Engine, abandoned since 2015 and Django 1.6 (2-clause BSD license).