---
title: "Troubleshooting guides"
description: "Find the guide for your problem, with likely causes, how to spot them, and how to fix them."
url: "https://www.metabase.com/docs/latest/troubleshooting-guide/"
version: "65"
---

# Troubleshooting guides

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

## Getting diagnostic info

- [Download diagnostic info](https://www.metabase.com/docs/latest/troubleshooting-guide/diagnostic-info.md)
- [Create a HAR file](https://www.metabase.com/docs/latest/troubleshooting-guide/create-har-file.md)
- [Profiling your Metabase](https://www.metabase.com/docs/latest/troubleshooting-guide/profiling-metabase.md)

## Installation

- [Running the Metabase JAR][running].
- [Running Metabase on Docker][docker].
- [Using or migrating from an H2 application database][appdb].

## Authentication

- [People can't log in to Metabase][login].
- [LDAP][ldap].
- [SAML][saml].

## Permissions

- [My permissions aren't working][permissions].
- [Row and column security isn't working][row-and-column].

## Databases

- [I can't connect to a database][db-connection].
- [I can't see my tables][cant-see-tables].
- [The data in Metabase doesn't match my database][sync-fingerprint-scan].
- [My database is slow][db-performance].
- [My connection or query is timing out][timeout].

## Questions and dashboards

- [I can't save my question or dashboard][proxies].
- [I can't view or edit my question or dashboard][view-edit].
- [My visualizations are wrong][visualization].
- [My dashboard is slow or failing to load][slow-dashboard].
- [My SQL question doesn't work][sql].
- [The dates and times in my questions and charts are wrong][incorrect-times].
- [My filters don't work][filters].
- [My linked filters don't work][linked-filters].

## Models

- [My model doesn't work][models].

## Email and alerts

- [Metabase isn't sending email][not-sending-email].
- [Troubleshooting notifications](https://www.metabase.com/docs/latest/troubleshooting-guide/notifications.md).

## Error messages

- [I'm getting an error message][error-message].

## Think you found a bug?

- [How to find known bugs or limitations][known-issues].
- [Filing a bug report][bugs].

## Feature requests

See [Requesting new features][feature-request].

## Metabase tutorials

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

## Metabase forum

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

## Upgrading Metabase

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

[appdb]: https://www.metabase.com/docs/latest/troubleshooting-guide/loading-from-h2.md
[bugs]: https://www.metabase.com/docs/latest/troubleshooting-guide/bugs.md
[cant-see-tables]: https://www.metabase.com/docs/latest/troubleshooting-guide/cant-see-tables.md
[cloud]: https://www.metabase.com/cloud
[db-connection]: https://www.metabase.com/docs/latest/troubleshooting-guide/db-connection.md
[db-performance]: https://www.metabase.com/docs/latest/troubleshooting-guide/db-performance.md
[docker]: https://www.metabase.com/docs/latest/troubleshooting-guide/docker.md
[error-message]: https://www.metabase.com/docs/latest/troubleshooting-guide/error-message.md
[feature-request]: https://www.metabase.com/docs/latest/troubleshooting-guide/requesting-new-features.md
[filters]: https://www.metabase.com/docs/latest/troubleshooting-guide/filters.md
[forum]: https://discourse.metabase.com/
[incorrect-times]: https://www.metabase.com/docs/latest/troubleshooting-guide/timezones.md
[known-issues]: https://www.metabase.com/docs/latest/troubleshooting-guide/known-issues.md
[ldap]: https://www.metabase.com/docs/latest/troubleshooting-guide/ldap.md
[learn]: https://www.metabase.com/learn
[linked-filters]: https://www.metabase.com/docs/latest/troubleshooting-guide/linked-filters.md
[login]: https://www.metabase.com/docs/latest/troubleshooting-guide/cant-log-in.md
[models]: https://www.metabase.com/docs/latest/troubleshooting-guide/models.md
[not-sending-email]: https://www.metabase.com/docs/latest/troubleshooting-guide/cant-send-email.md
[permissions]: https://www.metabase.com/docs/latest/troubleshooting-guide/permissions.md
[proxies]: https://www.metabase.com/docs/latest/troubleshooting-guide/proxies.md
[releases]: https://github.com/metabase/metabase/releases
[running]: https://www.metabase.com/docs/latest/troubleshooting-guide/running.md
[saml]: https://www.metabase.com/docs/latest/troubleshooting-guide/saml.md
[row-and-column]: https://www.metabase.com/docs/latest/troubleshooting-guide/row-and-column-security.md
[slow-dashboard]: https://www.metabase.com/docs/latest/troubleshooting-guide/my-dashboard-is-slow.md
[sql]: https://www.metabase.com/docs/latest/troubleshooting-guide/sql.md
[sync-fingerprint-scan]: https://www.metabase.com/docs/latest/troubleshooting-guide/sync-fingerprint-scan.md
[timeout]: https://www.metabase.com/docs/latest/troubleshooting-guide/timeout.md
[upgrade]: https://www.metabase.com/docs/latest/installation-and-operation/upgrading-metabase.md
[view-edit]: https://www.metabase.com/docs/latest/troubleshooting-guide/cant-view-or-edit.md
[visualization]: https://www.metabase.com/docs/latest/troubleshooting-guide/visualization.md