Version History

# Django Multiple Subdomains with django-hosts One Django project, multiple subdomains. ## Install ```bash pip install django-hosts ``` ## 1. Settings ```python # settings.py INSTALLED_APPS = ["django_hosts", ...] MIDDLEWARE = [ "django_hosts.middleware.HostsRequestMiddleware", # MUST be first ... "django_hosts.middleware.HostsResponseMiddleware", # MUST be last ] # django-hosts configuration ROOT_HOSTCONF = "config.hosts" DEFAULT_HOST = "api" # Default subdomain PARENT_HOST = "example.com" # Parent domain (IMPORTANT for URL generation) # Login URL for admin subdomain LOGIN_URL = "/login/" # Since admin is at root, login is at /login/ ``` ## 2. Hosts Config ```python # config/hosts.py from django.conf import settings from django_hosts import patterns, host host_patterns = patterns("", host(r"admin", "config.admin_urls", name="admin"), # admin.example.com host(r"api", settings.ROOT_URLCONF, name="api"), # api.example.com host(r"", settings.ROOT_URLCONF, name="default"), # example.com ) ``` ## 3. Admin URLs ```python # config/admin_urls.py from django.contrib import admin from django.urls import path, include from django.views.generic import RedirectView urlpatterns = [ # Prevent /admin/ loops (redirect to root) path("admin/", RedirectView.as_view(pattern_name="admin:index", permanent=True)), # Admin at root path("", admin.site.urls), ] ``` ## 4. Nginx ```nginx server { server_name admin.example.com; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; # Critical! proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } } ``` ## How It Works 1. Request: https://admin.example.com/ 2. …

# Django Multiple Subdomains with django-hosts One Django project, multiple subdomains. ## Install ```bash pip install django-hosts ``` ## Settings ```python INSTALLED_APPS = ["django_hosts", ...] MIDDLEWARE = [ "django_hosts.middleware.HostsRequestMiddleware", # First ... "django_hosts.middleware.HostsResponseMiddleware", # Last ] ROOT_HOSTCONF = "config.hosts" DEFAULT_HOST = "api" ``` ## Hosts Config ```python # config/hosts.py from django_hosts import patterns, host host_patterns = patterns("", host(r"admin", "config.admin_urls", name="admin"), # admin.example.com host(r"api", settings.ROOT_URLCONF, name="api"), # api.example.com host(r"", settings.ROOT_URLCONF, name="default"), # example.com ) ``` ## URL Configs ```python # config/admin_urls.py urlpatterns = [path("", admin.site.urls)] ``` ## Nginx ```nginx server { server_name admin.example.com; location / { proxy_pass http://127.0.0.1:8000; proxy_set_header Host $host; # Critical! } } ``` ## How It Works 1. Request: https://admin.example.com/users/ 2. Nginx forwards with Host: admin.example.com 3. django-hosts reads Host header 4. Routes to config.admin_urls 5. Serves admin panel ## Key Points - One Django project, multiple subdomains - Nginx passes Host header - django-hosts routes by subdomain - Separate URL configs per subdomain ## Allowed Hosts ```python ALLOWED_HOSTS = [".example.com"] # All subdomains ``` ## URL Generation ```python from django_hosts.resolvers import reverse admin_url = reverse("admin:index", host="admin") # → https://admin.example.com/ ```