🍺 BREW Explorer

← all formulae

cloud-sql-proxy

brew install cloud-sql-proxy v2.22.1 Apache-2.0

Go utility for secure IAM-authenticated connections to Google Cloud SQL instances with TLS 1.3 encryption.

Why you might care

Bridges your local applications to Cloud SQL without managing certificates or IP allowlists—authentication flows through GCP IAM instead. Essential if you're developing against Cloud SQL and want zero-trust security without the operational burden of certificate rotation. Single binary, works as a local proxy daemon.

Categories

Alternatives

gcloud sql connect mysql client psql
2.1k
30-day installs · #954
5.4k
90-day · #1050
15.0k
365-day · #1222
1.4k
★ GitHub stars · updated 3d ago

Build dependencies

go

GitHub topics

cloud-sql cloud-sql-proxy gcp google-cloud google-cloud-platform libraries

Links

Blurb generated by claude-haiku-4-5 on today.

Raw metadata
{
  "aliases": [],
  "alternatives": [
    "gcloud sql connect",
    "mysql client",
    "psql"
  ],
  "build_dependencies": [
    "go"
  ],
  "categories": [
    "networking",
    "database-client",
    "cloud"
  ],
  "caveats": null,
  "conflicts_with": [],
  "dependencies": [],
  "deprecated": 0,
  "deprecation_reason": null,
  "desc": "Utility for connecting securely to your Cloud SQL instances",
  "disable_reason": null,
  "disabled": 0,
  "enrichment_fetched_at": "2026-06-20T23:36:28+00:00",
  "first_seen": "2026-06-20T23:34:18+00:00",
  "full_name": "cloud-sql-proxy",
  "github_default_branch": "main",
  "github_last_commit_at": "2026-06-17T23:34:21Z",
  "github_readme_excerpt": "# Cloud SQL Auth Proxy\n\n[![CI][ci-badge]][ci-build]\n\n\u003e [!WARNING]\n\u003e **Go versions 1.25.2 and 1.24.8 are NOT compatible with Cloud Auth Proxy.**\n\u003e\n\u003e An update to the Go version 1.25.2 and Go 1.24.8 breaks SAN verificaton. This is because Cloud SQL includes a trailing dot in the DNS name within the certificate\u0027s Subject Alternative Name (SAN), which the above Go versions reject as a malformed DNS name.\n\u003e\n\u003e For more details, please see the related Go issue: [crypto/x509: quadratic complexity when checking name constraints ](https://github.com/golang/go/issues/75715).\n\n\n\u003e [!IMPORTANT]\n\u003e\n\u003e The Cloud SQL Auth Proxy does not currently support Unix domain socket\n\u003e connections to MySQL 8.4 instances. This is due to a [known issue](https://github.com/GoogleCloudPlatform/cloud-sql-proxy/issues/2317)\n\u003e involving the new default `caching_sha2_password` authentication plugin.\n\nThe Cloud SQL Auth Proxy is a utility for ensuring secure connections to your\nCloud SQL instances. It provides IAM authorization, allowing you to control who\ncan connect to your instance through IAM permissions, and TLS 1.3 encryption,\nwithout having to manage certificates.\n\nSee the [Connecting Overview][connection-overview] page for more information on\nconnecting to a Cloud SQL instance, or the [About the Proxy][about-proxy] page\nfor details on how the Cloud SQL Proxy works.\n\nThe Cloud SQL Auth Proxy has support for:\n\n- [Automatic IAM Authentication][iam-auth] (Postgres and MySQL only)\n- Metrics ([Cloud Monitoring][], [Cloud Trace][], and [Prometheus][])\n- [HTTP Healthchecks][health-check-example]\n- [Service account impersonation](#configuring-service-account-impersonation)\n- Separate Dialer functionality released as the [Cloud SQL Go Connector][go connector]\n- Configuration with [environment variables](#config-environment-variables)\n- Fully POSIX-compliant flags\n\nIf you\u0027re using Go, Java, Python, or Node.js, consider using the corresponding Cloud SQL\nconnector which does everything the Proxy does, but in ",
  "github_repo": "GoogleCloudPlatform/cloud-sql-proxy",
  "github_stars": 1424,
  "github_topics": [
    "cloud-sql",
    "cloud-sql-proxy",
    "gcp",
    "google-cloud",
    "google-cloud-platform",
    "libraries"
  ],
  "homepage": "https://github.com/GoogleCloudPlatform/cloud-sql-proxy",
  "homepage_og_description": null,
  "homepage_og_image": null,
  "homepage_title": null,
  "installs_30d": 2097,
  "installs_365d": 14989,
  "installs_90d": 5396,
  "keg_only": 0,
  "keg_only_reason": null,
  "last_seen": "2026-06-20T23:34:18+00:00",
  "license": "Apache-2.0",
  "llm_generated_at": "2026-06-20T23:48:04+00:00",
  "llm_model": "claude-haiku-4-5",
  "name": "cloud-sql-proxy",
  "oldnames": [],
  "one_liner": "Go utility for secure IAM-authenticated connections to Google Cloud SQL instances with TLS 1.3 encryption.",
  "optional_dependencies": [],
  "rank_30d": 954,
  "rank_365d": 1222,
  "rank_90d": 1050,
  "raw_hash": "e9ac002434c462d8",
  "recommended_dependencies": [],
  "revision": 0,
  "ruby_source_path": "Formula/c/cloud-sql-proxy.rb",
  "tap": "homebrew/core",
  "test_dependencies": [],
  "uses_from_macos": [],
  "version_head": "HEAD",
  "version_stable": "2.22.1",
  "versioned_formulae": [],
  "why_use_this": "Bridges your local applications to Cloud SQL without managing certificates or IP allowlists\u2014authentication flows through GCP IAM instead. Essential if you\u0027re developing against Cloud SQL and want zero-trust security without the operational burden of certificate rotation. Single binary, works as a local proxy daemon."
}