Install and Get Started with MySQL Workbench on Ubuntu

February 24, 2022


MySQL Workbench is a unified visual tool for database management. Its graphical interface provides database architects and administrators with an easier way to model data, build and run SQL queries, and maintain a database.

In this tutorial, you will learn how to install, configure, and get started with MySQL Workbench on Ubuntu (18.04 or 20.04).

How to Install and get started with Workbech on Ubuntu.


Installing MySQL Workbench on Ubuntu

MySQL Workbench is very easy to install and available in the local repository or through deb packages.

Decide which options is best for you and follow the steps in outlined below.

Installing MySQL Workbench Using the Apt Repository

The simplest way to install MySQL Workbench is to use the local apt repository. The only thing you need to do is download the package.

As a rule, always update and upgrade the system, before any installation:

sudo apt update && sudo apt upgrade

Now you can download and install Workbench with the command:

sudo apt install mysql-workbench

Installing MySQL Workbench Using Deb Packages

To install MySQL Workbench from the official apt repository, use the deb package from MySQL archives.

1. Start by navigating to MySQL APT Repository download page and click Download to save the deb package on your Ubuntu system.

Download MySQL APT repository deb package for Ubuntu.

2. Before the download starts, MySQL suggests to login or sign up for an Oracle Web account. To skip signing in for a free account, click No thanks, just start my download.

Skip signing up for a Oracle web account and start MySQL apt download.

3. When the dialogue box appears, select the Save file option and click Ok.

Save the mysql-apt-config deb file on your Ubuntu system.

4. Wait for the download to complete. Then, open a terminal window (Ctrl + Alt + t) to add the MySQL apt repository.

5. In most cases, the saved file will be located in the Downloads folder. To verify its location, navigate to Downloads and list the content of the directory:

cd Downloads
Navigate to Downloads folder and check contents.

6. Next, add the official MySQL repository to the apt source list by running the command:

sudo apt install ./mysql-apt-config_0.8.22-1_all.deb

Note: The name of the deb file may differ if you downloaded a different version of mysql-apt-config. Change the version number in the command above, if needed.

7. A pop-up window appears asking which MySQL product to install. As the required product is preselected, scroll down to Ok and hit Enter to continue installing.

Select which MySQL product to configure.

8. Wait for the installation to complete.

Complete installing apt package for MySQL Workbench.

10. Then, update the apt cache to add the new repository source:

sudo apt update

11. Finally, install MySQL Workbench by running:

sudo apt install mysql-workbench-community

12. Press y when asked to confirm the installation and wait for the process to complete.

Launch MySQL Workbench

Once you have installed the software, launch the database management tool:


The command prompts Workbench to launch and a new window will appear.

mysql workbench home screen showing mysql connections

If you prefer using the GUI, launch Workbench by searching for it in the Activities menu and clicking on the icon as seen below.


Configure MySQL Workbench

Before you start managing databases, you may want to modify the default settings. To do so, open the Edit drop-down menu and select Preferences.

edit preferences in mysql workbench

The Workbench Preferences window appears, consisting of several sections:

  • General Editors
  • SQL Editor
  • Administration
  • Modeling
  • Fonts & Colors
  • Others

Click through the tiles, inspect all the options, and adjust them to fit your needs.

Uninstall MySQL Workbench

To remove or uninstall MySQL Workbench on an Ubuntu system, use the command:

sudo apt remove mysql-workbench


With the help of this article, you should now know how to install MySQL Workbench on Ubuntu from the apt repository or the official deb package. You also learned how to configure and uninstall the software.

The next thing to learn is how to create a database with MySQL Workbench.

Was this article helpful?
Sofija Simic
Sofija Simic is an experienced Technical Writer. Alongside her educational background in teaching and writing, she has had a lifelong passion for information technology. She is committed to unscrambling confusing IT concepts and streamlining intricate software installations.
Next you should read
How To Show a List of All Databases in MySQL
October 13, 2022

With Structured Query Language (SQL), you can easily access and manage content in all your databases. This...
Read more
How to Check the MySQL Version In Linux
July 11, 2019

It is essential to know which version of MySQL you have installed. The version number helps to determine if a...
Read more
How To Set Up MySQL Master Slave Replication
January 16, 2024

In cloud computing, master-slave data replication refers to storing the same information on multiple servers.
Read more
How to Rename a MySQL Database
March 20, 2024

As an administrator, you may need to rename a database. However, for security, the command to rename a...
Read more