Troubleshooting guides

Problems, their causes, how to detect them, and how to fix them.

Getting diagnostic info

• Download diagnostic info
• Create a HAR file

Installation

• Running the Metabase JAR.
• Running Metabase on Docker.
• Using or migrating from an H2 application database.

Authentication

• People can’t log in to Metabase.
• LDAP.
• SAML.

Permissions

• My permissions aren’t working.
• My data sandboxes aren’t working.

Databases

• I can’t connect to a database.
• I can’t see my tables.
• The data in Metabase doesn’t match my database.
• My database is slow.
• My connection or query is timing out.

Questions and dashboards

• I can’t save my question or dashboard.
• I can’t view or edit my question or dashboard.
• My visualizations are wrong.
• My dashboard is slow or failing to load.
• My SQL question doesn’t work.
• The dates and times in my questions and charts are wrong.
• My filters don’t work.
• My linked filters don’t work.

Models

• My model doesn’t work.

Email and alerts

• Metabase isn’t sending email.

Error messages

• I’m getting an error message.

Think you found a bug?

• How to find known bugs or limitations.
• Filing a bug report.

Feature requests

See Requesting new features.

Metabase tutorials

For tutorials that walk you through how to use Metabase features, check out Learn Metabase.

Metabase forum

To see if someone else has run into a similar issue, check out our forum on Discourse.

Upgrading Metabase

Metabase adds new features and squashes bugs with each release. Upgrading to the latest and greatest may resolve your issue. If you’re using Metabase Cloud, we’ll handle the upgrades for you. To see what’s new, check out the release notes.