A Django app for managing computer equipment.

Installation

Install system dependencies:

sudo apt install python-dev libldap2-dev libsasl2-dev bind9-utils

Use mise to manage Python and uv:

mise trust
mise install

Install Python dependencies with uv:

uv sync

Run migrations and start the development server:

uv run python manage.py migrate
uv run python manage.py runserver

mise.toml sets DJANGO_DEBUG=1; without it DEBUG is off. Local overrides go in mdbsite/local_settings.py.

Production

MDB runs on sega under edb-infra's mdb role (roles/mdb.md there): gunicorn from a release directory per commit, its settings in the file MDB_SETTINGS names (/etc/mdb/settings.py), which mdbsite/settings.py executes last. A push to main that passes the tests and prek deploys itself while the repository variable DEPLOY_SEGA is true (.gitea/workflows/ci.yaml). The DNS and DHCP sync runs as root on sega: sudo mdb-sync.

Development tasks

Dump test data:

uv run python manage.py dumpdata mdb --natural-foreign --indent=4 > mdb/fixtures/test_data.json

Features

• Creates DHCPD configuration files
• Creates DNS zone files for BIND
• Creates PXE config files (with random secret for use with Puppet autosign)
• Partial IPv6 support