- Home
- Container Registries
- Django-OCI
Django-OCI
What it is
Django-OCI is an open-source Django module for building registries that follow the OpenContainers Distribution Specification. It provides API endpoints for pushing, pulling, and interacting with container images, and can be installed with `pip install django-oci` or from a GitHub checkout. Installation includes Django Rest Framework. The project can run in a local virtual environment or as part of a container-orchestrated registry. Filesystem storage is the default and is intended for smaller registries that do not use an external resource such as cloud storage. Authentication uses a Docker-style OAuth 2.0 flow with username and account-token credentials, plus JWT access tokens. Settings include the URL prefix, specification version, allowed content types, storage backend, session and token expiry, view rate limits, and authentication controls. The project is in early development, and most stated goals remain under development. It has no interface for viewing containers; private repositories and repository ownership or contributors are not yet implemented. The software is free and open source, subject to its project license.
For and against
For
- Provides endpoints for pushing and pulling images.
- Can run locally or in an orchestrated registry.
- Authentication uses OAuth 2.0 and JWT tokens.
- Configurable storage, expiry, and request limits.
Against
- No frontend for viewing containers.
- Private repositories are not implemented.
- Ownership and contributor features are not implemented.
- Most stated goals remain under development.
The verdict
Django-OCI supplies registry API endpoints and configurable authentication for Python-based registry projects. Its early development status and missing private-repository and frontend features are important considerations.
Who it suits
Django-OCI suits Python developers building and operating an OCI-compliant container registry. It is most relevant to teams comfortable working with Django and a registry without a built-in viewing interface.
Plans and prices
Open-source software
No hosted plan or usage limits stated
Read 11 Oct 2026 · vsoch.github.io
On the record
- API
- It provides distribution-spec API endpoints for pushing, pulling, and interacting with a registry.vsoch.github.io · read 11 Oct 2026
- Authentication
- Authentication uses a Docker-style OAuth 2.0 flow with username and token credentials and expiring JWT bearer tokens.vsoch.github.io · read 11 Oct 2026
- Authentication caution
- The documentation strongly discourages disabling authentication unless there is a specific, strong use case.vsoch.github.io · read 5 Oct 2026
- Client integrations
- There is no official client; the documentation describes Python Requests and the Reggie client as ways to interact with a registry.vsoch.github.io · read 11 Oct 2026
- Compliance
- The policy page encourages developers who create registries to ensure that their registries are GDPR compliant.vsoch.github.io · read 11 Oct 2026
- Configurable controls
- Settings include token and upload-session expiration, authenticated views, request rate limits, and an option to disable manifest tag deletion.vsoch.github.io · read 11 Oct 2026
- Configuration
- Settings include URL prefix, authentication, spec version, allowed content types, storage backend, session and token expiry, and view rate limits.vsoch.github.io · read 5 Oct 2026
- Dependency
- Installation includes Django Rest Framework as a dependency.vsoch.github.io · read 5 Oct 2026
- Deployment
- It can be deployed locally in a virtual environment or as part of a container orchestrated registry.vsoch.github.io · read 5 Oct 2026
- Development status
- The introduction says the project is still in early development and that most stated goals remain under development.vsoch.github.io · read 11 Oct 2026
- Frontend limit
- The module does not provide a frontend interface for viewing containers.vsoch.github.io · read 11 Oct 2026
- Installation
- The package can be installed with pip or from a GitHub clone, and its documented dependency is Django REST Framework.vsoch.github.io · read 11 Oct 2026
- License
- Use is governed by the project license, which users are asked to read and agree to before using the software.vsoch.github.io · read 5 Oct 2026
- No frontend
- The project does not yet provide a frontend interface for viewing containers.vsoch.github.io · read 5 Oct 2026
- Not implemented
- Private repositories and repository ownership or contributors are described as not yet implemented.vsoch.github.io · read 5 Oct 2026
- Privacy guidance
- The policy page encourages registry developers to ensure their registries are GDPR compliant.vsoch.github.io · read 5 Oct 2026
- Purpose
- Django-OCI is an open-source registry module for Python developers using Django to build OCI-compliant registries.vsoch.github.io · read 11 Oct 2026
- Repository privacy
- Private repositories and contributor ownership are described as planned model features that are not yet implemented.vsoch.github.io · read 11 Oct 2026
