Troubleshooting connections

Whitelisting IP addresses

If you’re using Retool cloud, you’ll need to whitelist our IP addresses (below) so we can connect to your data source.

  • 13.80.4.170/32
  • 13.93.15.89/32
  • 13.93.15.84/32
  • 13.76.231.249/32
  • 13.76.97.52/32
  • 13.76.194.227/32
  • 52.177.12.28/32
  • 52.177.12.26/32
  • 52.177.118.220/32
  • 52.175.194.171/32
  • 52.175.251.223/32
  • 52.247.195.225/32

Each database has a slightly different way of allowing remote connections, but here are a few links to popular ones:

If you run into any problems whitelisting IPs, reach out to support through our Intercom widget on the bottom right of your screen. Check out our connection docs for more info.

Connection strings and the wrong database

For databases like PostgreSQL and MongoDB, Retool lets you connect using a connection string or traditional credentials (username, database, password, port).

If you’re using a connection string, they usually follow a standard format:

The last slash (/mydb) references the database name that you want to connect to. If you’re copying your connection string from a console (like MongoDB Atlas), that might default to something like /test – make sure to replace it with your intended database.

Database username and password vs. provider username and password

Whether you’re using a connection string or regular credentials, you’ll need to enter your database username and password. There are not the same as the credentials you use to login to web consoles.

For example, if you’re using MongoDB Atlas, you’ll have a username and password to login to the web console: these are not what you use to connect to a resource in Retool. You need your database username and password, which you were prompted for when you created the cluster.

Best practice is to create a new database user specifically for connecting with Retool (you can even call it retool if you’d like).

SSL / Certificates

Some Retool integrations allow you to connect to your data with end-to-end encryption using SSL, like MongoDB. This keeps your data safe and also prevents threats like MITM attacks. If we support SSL for a resource, there will be an SSL toggle “SSL” on the resource connection page.

In most cases, this is enough to ensure that all connections are end-to-end encrypted. Sometimes, though, your database might use a custom SSL certificate to encrypt traffic instead of a publicly signed certificate. In those cases, you’ll need to tell Retool to trust the custom SSL certificate. Once you’ve checked “Connect using SSL,” you’ll see another checkbox for a custom certificate:

SSH Tunnels

If you’re having trouble whitelisting Retool’s IP address or want to use SSH, Retool lets you connect to data sources that are in a private network with SSH Tunnels. Check out our documentation and common errors you might run into here.

Common error messages

  • getaddrinfo ENOTFOUND – the hostname you provided doesn’t work. It could be incorrect or private (behind a VPC).
  • password authentication failed for user – you’ve got the wrong password, or the wrong username. Make sure to check both.
  • database "" does not exist – you’re trying to connect to a database that doesn’t exist. Check your spelling!
  • connect ECONNREFUSED – you’ve got the wrong port, or you haven’t properly whitelisted Retool’s IP address.

Updated about a month ago


Troubleshooting connections


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.