Connect to Docker database with an external tool


Learn how to connect a database management tool to a docker database

1 Jul, 2021 · 2 min 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

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
      MYSQL_DATABASE: my_db
      MYSQL_USER: root
      MYSQL_PASSWORD: root

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

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!

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

Spread the knowledge with fellow developers on Twitter
Tweet this tip
Powered by Webmentions - Learn more

Read next 📖

Develop a local WordPress theme using Docker

11 Oct, 2021 · 2 min read

Develop a local WordPress theme using Docker

Guide to set up your WordPress site in Docker

14 Sep, 2021 · 4 min read

Guide to set up your WordPress site in Docker

Join 2100 devs and subscribe to my newsletter