> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superblocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting database integrations

If you encounter errors connecting database integrations (Postgres, MySQL, MariaDB, MongoDB, SQL Server) from Superblocks, check the following conditions / scenarios:

#### Correct settings for:

* **Host/IP address** - Results in a `getaddrinfo ENOTFOUND` error when the hostname is incorrect.
* **Database name** - Specify the database name, not the database instance identifier. Otherwise, Superblocks will report an `Unknown database` error.
* **Username and Password** - Invalid credentials result in `Access denied` or `password authentication failed for user` errors.

#### Inbound access blocked

Is there a firewall blocking access to the database? For example, if you're using Superblocks Cloud, make sure your VPC security groups have the right inbound rules to allow access from the [Superblocks IP addresses](/enterprise/security/overview#ip-addresses). Similarly, if you're [self-hosting the data plane](/enterprise/hybrid-architecture/overview), make sure that it is running inside the same network as the database or is allowed to connect to your database externally.
Expect to see `Connection timeout: failed to create socket`, `timeout expired`,  or similar errors when the database instance is not accessible from Superblocks.

#### Server listening internally only

If you're running your own database server, you may need to configure it to accept remote connections, instead of listening locally on its network interfaces. If the latter is true, then you can configure the server to listen on all interfaces by editing the database config file and setting the bind / listening address accordingly (for example `bind_address = 0.0.0.0` for [MySQL](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_bind_address) or `listen_addresses = '*'` for [Postgres](https://www.postgresql.org/docs/current/runtime-config-connection.html#GUC-LISTEN-ADDRESSES)).

#### Testing with self-hosted data plane using localhost

For Docker containers, `localhost` inside a container doesn't mean the same from the context of the host where the container is running. As such, you'll see `ECONNREFUSED` errors if you've specified `localhost` in the integration form. Instead, use `host.docker.internal` in the Superblocks integration form configuration. More on this in the [Docker docs here](https://docs.docker.com/desktop/networking/#i-want-to-connect-from-a-container-to-a-service-on-the-host).