django-cloud-sql-postgres

Status : Production Ready Last Updated : 2026-01-24 Dependencies : None Latest Versions : Django@5.1 , psycopg2-binary@2.9.9 , gunicorn@23.0.0 , google-cloud-sql-connector@1.12.0 For Cloud SQL Python Connector (recommended for local dev): Why this matters: settings.py (production with Unix socket): CRITICAL: CRITICAL: Key Points: requirements.txt: settings.py additions: Why these settings: Install Cloud SQL Auth Proxy: Run the proxy: Set environment variables for local dev: Key Points: For production migrations (via Cloud Build or local with proxy): gunicorn.conf.py (optional, for fine-tuning): app.yaml entrypoint options: Key Points: Verify deployment: ALWAYS DO: NEVER DO: This skill prevents 12 documented issues : Error : django.db.utils.OperationalError: could not connect to server: No such file or directory Source : Why It Happens : App Engine can't find the Unix socket because beta_settings.cloud_sql_instances is missing in app.yaml Prevention : Always include beta_settings.cloud_sql_instances: "PROJECT:REGION:INSTANCE" in app.yaml Error : django.db.utils.OperationalError: connection refused or could not connect to server: Connection refused Source : Why It Happens : Cloud SQL Auth Proxy is not running or bound to wrong port Prevention : Start cloud-sql-proxy PROJECT:REGION:INSTANCE before running Django locally. Verify it's running on port 5432. Error : FATAL: password...