// 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
Share

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

  1. FIX 1Test the network path

    1. 01From the Metabase host run nc -v your-db-host 5432 (use your port)
    2. 02If it fails, open the firewall or security group for Metabase's IP
    Did this fix it?
  2. FIX 2Allowlist Metabase Cloud IPs

    1. 01Find Metabase Cloud's IP addresses in the Cloud docs
    2. 02Add them to your database's allowlist or security group
    Did this fix it?
  3. FIX 3Verify credentials and privileges

    1. 01Log in with the same user via psql or your database client
    2. 02Grant SELECT on the schemas Metabase needs
    Did this fix it?
  4. FIX 4Fix SSL certificate errors

    1. 01Go to Admin > Databases > your database > Show advanced options
    2. 02In Additional JDBC connection string options add trustServerCertificate=true (SQL Server)
    3. 03Save and retry
    Did this fix it?
  5. FIX 5Confirm the connection

    1. 01Open the SQL editor and run SELECT 1
    2. 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 us

Watch Metabase Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other Metabase errors

All 14 Metabase errors and fixes →