Getting started overview

Prerequisites

• Python 3.12–3.14 (package requires >=3.12,<3.15)
• A Pulumi project with Azure credentials and an existing resource group + VNet you create yourself
• A Django project that will be deployed from Git to App Service
• Entra tenant ID for Postgres AAD authentication

Two projects, one package

You can use one Git repository or two. Functionally there are two integration surfaces:

1. Infra (Pulumi) — creates Azure resources. Import only:

from pulumi_django_azure.django_deployment import DjangoDeployment, HostDefinition

1. App (Django) — consumes App Settings and runtime helpers. Import settings/middleware from pulumi_django_azure.settings and related modules. Do not import django_deployment unless you also run Pulumi from that codebase.

Next:

• Pulumi stack
• Django app

Then follow Domains and HTTPS and Database for the multi-pass deploy and Entra role setup.