// troubleshooting guide · metabase
Metabase Can't Connect to Database
- Status
- Workaround available
- platforms:
- Metabase Cloud, self-hosted
- updated:
- November 16, 2026
- reports:
- 3
- Method
- how we research
RUNBOOK · metabase/cant-connect-database5 FIXES
// quick answer
Check whether the problem is on the Metabase side (connection settings, version support) or the database side (server down, network or IP allowlist, credentials, privileges). On Metabase Cloud, add Metabase's IP addresses to your database allowlist.
Most likely fix: Test the network path
How to fix it
// try these in order, the most common fix is first
FIX 1Test the network path
- 01From the Metabase host run nc -v your-db-host 5432 (use your port)
- 02If it fails, open the firewall or security group for Metabase's IP
Did this fix it?FIX 2Allowlist Metabase Cloud IPs
- 01Find Metabase Cloud's IP addresses in the Cloud docs
- 02Add them to your database's allowlist or security group
Did this fix it?FIX 3Verify credentials and privileges
- 01Log in with the same user via psql or your database client
- 02Grant SELECT on the schemas Metabase needs
Did this fix it?FIX 4Fix SSL certificate errors
- 01Go to Admin > Databases > your database > Show advanced options
- 02In Additional JDBC connection string options add trustServerCertificate=true (SQL Server)
- 03Save and retry
Did this fix it?FIX 5Confirm the connection
- 01Open the SQL editor and run SELECT 1
- 02Check Admin > Tools > Logs for the real error if it fails
Did this fix it?
SANDBOX · metabase RUNS IN YOUR BROWSER
Try it: browse a sample shop and watch visitors, funnels and live data arrive
A hands-on Metabase-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Adding a database fails, existing questions error out, or you see 'Connections cannot be acquired from the underlying database'.
Why it happens
- C-01Database server down or not accepting connections
- C-02Firewall or IP allowlist blocking Metabase (common with Metabase Cloud)
- C-03Wrong host, port, database name, user or password
- C-04Metabase user lacks privileges
- C-05SSL or certificate mismatch
- C-06Metabase version too old for the database version
// this guide also covers
- metabase can't connect to database
- metabase connection refused
- metabase connections cannot be acquired
- metabase cloud ip address
Still not working?
If Metabase keeps failing, you're not alone. See every Metabase problem users report or the alternatives people switch to.
Done fighting Metabase? Our small team builds your own Metabase alternative, or any software you need: web, mobile, games, desktop. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
Superset Dashboard Slow or Charts Timing Out (Apache Superset)
Power BI Gateway Offline or Could Not Be Reached (Microsoft Power BI)
Looker Studio GA4 Quota Exceeded Error (Looker Studio)
Tableau "Unable to Start Due to an Internal Licensing Error" (Tableau)
PostHog Toolbar or Heatmaps Not Loading (PostHog)
Other Metabase errors
- Metabase Dashboard Slow or Not Loading
- Metabase 'Your Question Took Too Long' Error
- Metabase Not Syncing New Tables or Columns
- Metabase Filter Dropdown Not Showing Values
- Metabase Linked Filters Not Working
- Metabase Not Sending Emails or Alerts
- Metabase Tables Not Showing
- Metabase Dates and Times Wrong (Timezone Off)