Connect to Docker database with an external tool

β€” 3 minute read


Docker is pretty awesome, and when creating a database instance with Docker, we can log in through the terminal command.

However, I'm one for graphic Database tools, so today I'll guide you through how to connect to a Docker database.

Created the Docker database image permalink

For this example, I'm going to use a MariaDB instance. The purpose of today is to show you how to connect with it.

Create a new docker-compose.yml file. This is the configuration file for Docker.

version: '3.7'

image: mariadb
restart: unless-stopped
- db_data:/var/lib/mysql
- 3307:3306

volumes: db_data:

Above, we create a simple MariaDB image. I map the volume to a local folder (db_data). Furthermore, we set the environment to have some log-in possibility and a default database.

But the critical part for connecting is the ports! The first number is the port we can connect to. We mustn't use 3306 for this since this is our default system database.

I choose to use 3307 as it's close to what we know. You can, however, change this to anything that's not in use.

Now when we run docker-compose up, we spool up this database.

Docker MySQL instance

Connecting to the Docker database permalink

Alright, let's see how we can now connect to this, I'm using TablePlus, but the concept is the same for any tool.

We start by creating a new connection.

TablePlus connect to Docker instance

The main parts here are:

  • host: as this will be the default docker host
  • port: 3307 as we described above
  • user: the user you set in the environment
  • password: the password set in the environment

Now you should be able to test and connect with the Docker database!

Thank you for reading, and let's connect! permalink

Thank you for reading my blog. Feel free to subscribe to my email newsletter and connect on Facebook or Twitter