Compare Versions

--- Version 1+++ Version 2@@ -7,21 +7,29 @@ pip install django-hosts
 ```
 
-## Settings
+## 1. Settings
 ```python
+# settings.py
 INSTALLED_APPS = ["django_hosts", ...]
 MIDDLEWARE = [
-    "django_hosts.middleware.HostsRequestMiddleware",  # First
+    "django_hosts.middleware.HostsRequestMiddleware",  # MUST be first
     ...
-    "django_hosts.middleware.HostsResponseMiddleware",  # Last
+    "django_hosts.middleware.HostsResponseMiddleware",  # MUST be last
 ]
+
+# django-hosts configuration
 ROOT_HOSTCONF = "config.hosts"
-DEFAULT_HOST = "api"
+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/
 ```
 
-## Hosts Config  
+## 2. Hosts Config  
 ```python
 # config/hosts.py
+from django.conf import settings
 from django_hosts import patterns, host
 
 host_patterns = patterns("",
@@ -31,35 +39,59 @@ )
 ```
 
-## URL Configs
+## 3. Admin URLs
 ```python
 # config/admin_urls.py
-urlpatterns = [path("", admin.site.urls)]
+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),
+]
 ```
 
-## Nginx
+## 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/users/
+1. Request: https://admin.example.com/
 2. Nginx forwards with Host: admin.example.com
 3. django-hosts reads Host header
 4. Routes to config.admin_urls
-5. Serves admin panel
+5. Serves admin panel at root
+
+## Preventing Redirect Loops
+
+The redirect loop `/admin/admin/login/` happens when:
+- Admin is served at root of subdomain
+- But Django still tries to redirect to `/admin/`
+
+**Fixes:**
+1. Set `LOGIN_URL = "/login/"` in settings
+2. Set `PARENT_HOST = "example.com"` for proper URL generation
+3. Add redirect from `/admin/` to `/` in admin_urls.py
 
 ## Key Points
-- One Django project, multiple subdomains
-- Nginx passes Host header
-- django-hosts routes by subdomain
-- Separate URL configs per subdomain
+- Admin served at admin.example.com/ (root)
+- Login at admin.example.com/login/ (NOT /admin/login/)
+- PARENT_HOST required for django-hosts URL generation
+- Redirect /admin/ to / prevents old URL loops
 
 ## Allowed Hosts
 ```python