Skip to content

Configuration

MedUX is configured primarily through environment variables, loaded from a .env file in the working directory where manage.py (or the medux command) runs.

Environment Variables

Database

Variable Default Description
DATABASE_ENGINE django.db.backends.sqlite3 Database backend
DATABASE_NAME db.sqlite3 Database name or file path
DATABASE_USER Database user
DATABASE_PASS Database password
DATABASE_HOST localhost Database host
DATABASE_PORT Database port

Application

Variable Default Description
DEBUG False Enable Django debug mode
SECRET_KEY Django secret key (required in production)
ALLOWED_HOSTS Comma-separated list of allowed hostnames

Warning

Never run with DEBUG=True in production. Always set a strong SECRET_KEY.

Static & Media Files

Variable Default Description
STATIC_ROOT Directory for collected static files
MEDIA_ROOT Directory for uploaded files

Scoped Settings

Beyond environment variables, MedUX uses a scoped settings system for runtime configuration that can be adjusted per tenant, group, device, or user. See the Scoped Settings developer guide for details.