MySQL Workbench

2.5.1 Installing

MySQL Workbench for macOS is distributed as a DMG file. The file is named mysql-workbench-community-version-osx.dmg, where version is the MySQL Workbench version. MySQL Workbench provides platform support for the latest version of macOS only (see supported platforms). The previous version continues to be supported for a transition period of six months after each new version of macOS is released.

Downloads are available at

To install MySQL Workbench on macOS, download the file. Double-click the downloaded file. You will be presented with the installation window shown in the figure that follows.

Figure 2.1 MySQL Workbench macOS Installation Window

Content is described in the surrounding text.

Drag the MySQL Workbench icon onto the Applications icon as instructed. MySQL Workbench is now installed.

You can now launch MySQL Workbench from the Applications folder, or from the command line:

shell> /Applications/ --help

This will display the available command-line options:

MySQLWorkbench [<options>] [<name of a model file or sql script>]
  --query [<connection>|<connection string>]
                          Open a query tab and ask for connection if nothing is specified.
                          If named connection is specified it will be opened,
                          else connection will be created based on the given connection string,
                          which should be in form <user>@<host>:<port>
  --admin <instance>      Open a administration tab to the named instance
  --upgrade-mysql-dbs     Open a migration wizard tab
  --model <model file>    Open the given EER model file
  --script <sql file>     Open the given SQL file in an connection, best in conjunction
                          with a query parameter
  --run-script <file>     Execute Python code from a file
  --run <code>            Execute the given Python code
  --run-python <code>     Execute the given Python code
  --migration             Open the Migration Wizard tab
  --quit-when-done        Quit Workbench when the script is done
  --log-to-stderr         Also log to stderr
  --help, -h              Show command line options and exit
  --log-level=<level>     Valid levels are: error, warning, info, debug1, debug2, debug3
  --verbose, -v           Enable diagnostics output
  --version               Show Workbench version number and exit
  --open <file>           Open the given file at startup (deprecated, use script, model etc.)