Web application for tracking IT inventory: assets, network interfaces, IP addresses, OS records, locations, guest device registrations, and network approval workflows.

Built with Django 6, PostgreSQL, Redis, Celery, and django-allauth.

cp .env.example .env        # edit values as needed
docker compose build
docker compose up -d
docker compose run --rm web python manage.py migrate
docker compose run --rm web python manage.py createsuperuser

The application runs at http://localhost:8000/.

itin/             Django project settings, URLs, WSGI/ASGI
inventory/        Main app: models, views, templates, API
templates/        Shared and app-level templates
static/           Static assets

All configuration is done via environment variables. See .env.example for a full list.

The application uses django-allauth OpenID Connect. In this project, the provider is configured in itin/settings.py through the SOCIALACCOUNT_PROVIDERS dictionary, so it is settings-based configuration. You do not need to create provider credentials in Django admin.

Required:

ENTRA_TENANT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ENTRA_OIDC_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ENTRA_OIDC_CLIENT_SECRET=your-client-secret-value

Optional:

ENTRA_OIDC_PROVIDER_ID=entra

ENTRA_OIDC_PROVIDER_ID defaults to entra, and allauth builds the callback URL as:

/accounts/oidc/<provider_id>/login/callback/

With the default value, the callback path is:

/accounts/oidc/entra/login/callback/

In Azure Portal > Microsoft Entra ID > App registrations > your app > Authentication, set Web redirect URI to:

https://itin.ujf.cas.cz/accounts/oidc/entra/login/callback/

If you change ENTRA_OIDC_PROVIDER_ID, update the redirect URI accordingly.

In Django admin (/admin/sites/site/), set the Site domain to your real host (for example itin.ujf.cas.cz). allauth uses this value when generating absolute URLs.

docker compose up -d web

The Entra ID login option appears on /accounts/login/. Users are created on first successful SSO login and matched by email.

docker compose up -d              # all services (web, db, redis, celery, qcluster)
docker compose up -d web          # web server only
docker compose logs -f web        # follow web logs
docker compose run --rm web python manage.py migrate    # run migrations
docker compose run --rm web python manage.py shell      # Django shell

• Set DJANGO_DEBUG=0
• Set a strong DJANGO_SECRET_KEY
• Set DJANGO_ALLOWED_HOSTS and DJANGO_CSRF_TRUSTED_ORIGINS to your domain
• Set DJANGO_SESSION_COOKIE_SECURE=1 and DJANGO_CSRF_COOKIE_SECURE=1
• Use docker-compose.prod.yml if available