Skip to content

The way to install MySQL Workbench on Linux systems varies slightly across different distributions. Below, you’ll find a general guide for installing MySQL Workbench, along with specific instructions for popular Linux distributions such as Ubuntu, Fedora, and CentOS.

General installation steps

  1. Open a terminal window.
  2. Update your package list to ensure you get the latest version of the software.
sudo apt-get update
  1. Install MySQL Workbench using your distribution’s package manager.

For Ubuntu and Debian-based systems, use:

sudo apt-get install mysql-workbench

For Fedora:

sudo dnf install mysql-workbench

For CentOS and RHEL-based systems, you might need to enable the EPEL repository first, then install MySQL Workbench using YUM:

sudo yum install epel-release
sudo yum install mysql-workbench

What if MySQL Workbench is not available in your repository?

If MySQL Workbench isn’t available in your distribution’s default repository, you can download it directly from the MySQL website.

  1. Go to the MySQL Downloads page.
  2. Select the version compatible with your Linux distribution.
  3. Download the .deb or .rpm package, depending on your distribution.
  4. Install the downloaded package. For .deb packages (Debian/Ubuntu), use:
sudo dpkg -i mysql-workbench-community_version_amd64.deb

Replace version with the actual version number of your downloaded file. For .rpm packages (Fedora/CentOS), use:

sudo rpm -ivh mysql-workbench-community-version.x86_64.rpm

Post-installation steps

After installation, you can launch MySQL Workbench from your applications menu or by executing mysql-workbench in the terminal.

Troubleshooting common issues

  • Dependency issues: If you encounter dependency errors during installation, try installing those dependencies manually or using your package manager’s option to automatically handle dependencies.
  • Running MySQL Workbench: If MySQL Workbench does not start, check the terminal for error messages. It might be missing libraries or permissions.

Written by

Robert Cooper avatar

Robert Cooper

Senior Engineer at Basedash

Robert Cooper is a senior engineer at Basedash who builds full-stack product systems across SQL data infrastructure, APIs, and frontend architecture. His work focuses on application performance, developer velocity, and reliable self-hosted workflows that make data operations easier for teams at scale.

View full author profile →

Looking for an AI-native BI tool?

Basedash lets you build charts, dashboards, and reports in seconds using all your data.