Skip to content

With the introduction of Apple’s M1 chip, many applications required updates or workarounds to function seamlessly. MySQL Workbench is an essential tool for many engineers and developers, so getting it up and running on an M1 Mac is crucial. Let’s delve into how to achieve this.

Pre-requisites

Before installing MySQL Workbench, ensure you have the following:

  • Mac with M1 Chip: This guide specifically targets the M1 series.

  • Homebrew: The package manager for macOS.

    If you haven’t installed Homebrew yet, you can do it by running:

    /bin/bash -c "$(curl -fsSL <https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh>)"
    

Installation

  1. Install MySQL:

    First, ensure you have MySQL installed. You can use Homebrew for this:

    brew install mysql
    

    After the installation, you can start the MySQL server using:

    brew services start mysql
    
  2. Install MySQL Workbench:

    As of my last update, MySQL Workbench might still not have native M1 support. You can check for the latest release on MySQL’s official download page. If there’s an ARM version available, download and install that. If not, proceed with the steps below:

    a. Install using Homebrew:

    brew install --cask mysqlworkbench
    

    b. Once installed, try launching MySQL Workbench from your Applications folder or use Spotlight.

Post-installation Tips

  1. Creating a Connection:

    When you first launch MySQL Workbench, you’ll want to create a connection to your MySQL server.

    • Click on the + icon next to “MySQL Connections”.
    • Enter your connection details. If you’re connecting to a local MySQL instance, the hostname will typically be localhost or 127.0.0.1.
  2. Default Credentials:

    If you’re using the default setup from Homebrew, your initial username is root with no password. It’s recommended to set a password or modify user privileges for security reasons.

Troubleshooting

If you encounter issues, consider the following common solutions:

  1. Rosetta 2: Some versions of MySQL Workbench might require Rosetta 2. If Workbench crashes upon startup:
    • Navigate to the Applications folder.
    • Right-click on MySQL Workbench and select “Get Info”.
    • Check the box for “Open using Rosetta”.
  2. Connection Errors: If you’re unable to connect:
    • Ensure the MySQL server is running: brew services list and look for mysql.
    • Check firewall settings and ensure it’s not blocking the connection.
  3. Graphics Issues: Some users report graphical glitches. While not ideal, try resizing the Workbench window or restarting the application.

Conclusion

Running MySQL Workbench on an M1 Mac can require a few extra steps, but once set up, it offers the robust database management experience developers expect. Always refer to official documentation and community forums for the most recent solutions and updates.

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.