django-sysconfig

Schema-driven, database-backed runtime configuration for Django.

Define typed config fields in code. Store values in the database. Edit everything live through a built-in admin UI — without touching settings.py.

django-sysconfig demo

Install

pip install django-sysconfig

# settings.py
INSTALLED_APPS = [
    "django_sysconfig",   # add at the top
    ...
]

python manage.py migrate

Quick example

# myapp/sysconfig.py
from django_sysconfig.registry import register_config, Section, Field
from django_sysconfig.frontend_models import BooleanFrontendModel, IntegerFrontendModel
from django_sysconfig.validators import RangeValidator

@register_config("myapp")
class MyAppConfig:
    class General(Section):
        label = "General"

        maintenance_mode = Field(BooleanFrontendModel, label="Maintenance Mode", default=False)
        max_items = Field(IntegerFrontendModel, label="Max Items", default=100,
                          validators=[RangeValidator(min_value=1, max_value=10_000)])

# anywhere in your project
from django_sysconfig.accessor import config

if config.get("myapp.general.maintenance_mode"):
    return HttpResponse("Down for maintenance.", status=503)

Staff can toggle maintenance_mode at /admin/config/ — no code change, no redeploy.

Documentation

Full guides, API reference, and examples are in the docs.

Quick Start — up and running in 5 minutes
Installation — full setup guide

Contributing

See CONTRIBUTING.md. Issues and pull requests are welcome.

Security

Please do not open a public issue for security vulnerabilities. Report them privately via GitHub Security Advisories.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_sysconfig-1.2.0.tar.gz (51.7 kB view details)

Uploaded Aug 15, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

django_sysconfig-1.2.0-py3-none-any.whl (49.6 kB view details)

Uploaded Aug 15, 2026 Python 3

File details

Details for the file django_sysconfig-1.2.0.tar.gz.

File metadata

Download URL: django_sysconfig-1.2.0.tar.gz
Upload date: Aug 15, 2026
Size: 51.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for django_sysconfig-1.2.0.tar.gz
Algorithm	Hash digest
SHA256	`8b389ec8d5453f1ac138936cd27b4df2f01ea121b6bf5b80d28a2064ffaad868`
MD5	`11e52a0c93d51b3bb87fa14d0f5c1b0f`
BLAKE2b-256	`e698b1f063cc1dfee41c972de3278a04b62bac81ee927f3b0d9c1d4b5058ae61`

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_sysconfig-1.2.0.tar.gz:

Publisher: release.yml on krishnamodepalli/django-sysconfig

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: django_sysconfig-1.2.0.tar.gz
- Subject digest: 8b389ec8d5453f1ac138936cd27b4df2f01ea121b6bf5b80d28a2064ffaad868
- Sigstore transparency entry: 2473237150
- Sigstore integration time: Aug 15, 2026
Source repository:
- Permalink: krishnamodepalli/django-sysconfig@66b6f7c18dc4b05605b09cee5d44b61514526b7d
- Branch / Tag: refs/heads/master
- Owner: https://github.com/krishnamodepalli
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@66b6f7c18dc4b05605b09cee5d44b61514526b7d
- Trigger Event: push