To be able to install and run MySQL Workbench on Windows your system needs to have libraries listed below installed. The listed items are provided as links to the corresponding download pages where you can fetch the necessary files. Microsoft.NET Framework 4.5. In addition to the core installation, the Package Installer also includes Chapter 3, Installing a MySQL Launch Daemon and Chapter 4, Installing and Using the MySQL Preference Pane, both of which simplify the management of your installation. Navicat for MySQL, DBeaver, and Sequel Pro are probably your best bets out of the 15 options considered. 'Excellent choice of import/export options' is the primary reason people pick Navicat for MySQL over the competition. This page is powered by a knowledgeable community that helps you make an informed decision.

Recommend switching to Docker

I finally switched to using Docker for local development on macOS. While the following tutorial works for macOS Catalina, it has limitations. I recommend following my latest tutorial on installing Apache, MySQL, and PHP on macOS using Docker.

Note: This post is for new installations. If you have installed Apache, PHP, and MySQL for Mac OS Mojave, read my post on Updating Apache, PHP, and MySQL for macOS Catalina.

I am aware of the web server software available for macOS, notably MAMP, as well as package managers like brew. These get you started quickly. But they forego the learning experience and, as most developers report, can become difficult to manage.

macOS runs atop UNIX. Most UNIX software installs easily on macOS. In Additional, Apache and PHP come preinstalled with macOS. So to create a local web server, all you need to do is configure Apache and install MySQL.

Running Commands

First, open the Terminal app and switch to the root user so you can run the commands in this post without any permission issues:

Enable Apache on macOS

Verify It works! by accessing http://localhost

Enable PHP for Apache

First, make a backup of the default Apache configuration. This is good practice and serves as a comparison against future versions of macOS.

Now edit the Apache configuration. Feel free to use a different editor if you are not familiar with vi.

Uncomment the following line (remove #):

Restart Apache:

You can verify PHP is enabled by creating a phpinfo() page in your DocumentRoot.

The default DocumentRoot for macOS Catalina is /Library/WebServer/Documents. You can verify this from your Apache configuration.

Now create the phpinfo() page in your DocumentRoot:

Verify PHP by accessing http://localhost/phpinfo.php

Install MySQL on macOS Catalina

Download and install the latest MySQL generally available release DMG for macOS. MySQL 8 is the latest version. But older versions are available if you need to support older applications.

When the install completes it will provide you with a temporary password. Copy this password before closing the installer. You will use it again in a few steps.

The README suggests creating aliases for mysql and mysqladmin. However there are other commands that are helpful such as mysqldump. Instead, you can update your path to include /usr/local/mysql/bin.

Note: You will need to open a new Terminal window or run the command above for your path to update.

Finally, you should run mysql_secure_installation. While this isn't necessary, it's good practice to secure your database. This is also where you can change that nasty temporary password to something more manageable for local development.

Connect PHP and MySQL

You need to ensure PHP and MySQL can communicate with one another. There are several options to do so. I like the following as it doesn't require changing lots of configuration:

Additional Configuration (optional)

The default configuration for Apache 2.4 on macOS seemed pretty lean. For example, common modules like mod_rewrite were disabled. You may consider enabling this now to avoid forgetting they are disabled in the future.

I edited my Apache Configuration:

I uncommented the following lines (remove #):

If you develop multiple projects and would like each to have a unique url, you can configure Apache VirtualHosts for macOS.

If you would like to install PHPMyAdmin, return to my original post on installing Apache, PHP, and MySQL on macOS.

Find this interesting? Let's continue the conversation on Twitter.

Chapter 3. Installing and Launching MySQL Workbench

Table of Contents

3.1. Hardware Requirements

3.2. Software Requirements

3.3. Starting MySQL Workbench

3.3.1. Installing MySQL Workbench on Windows

3.3.2. Launching MySQL Workbench on Windows

3.3.3. Uninstalling MySQL Workbench on Windows

3.3.4. Installing MySQL Workbench on Linux

3.3.5. Launching MySQL Workbench on Linux

3.3.6. Uninstalling MySQL Workbench on Linux

3.3.7. Installing MySQL Workbench on Mac OS X

3.3.8. Launching MySQL Workbench on Mac OS X

3.3.9. Uninstalling MySQL Workbench on Mac OS X

3.4. Activation Procedure (Commercial Version)

MySQL Workbench is available for the following platforms:

Binary distributions of MySQL Workbench are avaliable for the above platforms. Source code distributions are also available as a tar.gz package, or an RPM package.

The following sections explain the installation process for each of these platforms.

MySQL Workbench requires a current system to run smoothly. The minimum hardware requirements are:

• CPU: Intel Core or Xeon 3GHz (or Dual Core 2GHz) or equal AMD CPU

• Cores: Single (Dual/Quad Core is recommended)

• RAM: 4 GB (6 GB recommended)

• Graphic Accelerators: nVidia or ATI with support of OpenGL 1.5 or higher

• Display Resolution: 1280×1024 is recommended, 1024×768 is minimum.

The following operating systems are officially supported:

• Windows 7 (64-bit, Professional level or higher)

• Mac OS X 10.6.1+

• Ubuntu 9.10 (64bit)

• Ubuntu 8.04 (32bit/64bit)

For convenience the following builds are also available:

• Windows XP SP3, Vista

• Mac OSX (10.5 and 10.6) Intel

• Ubuntu 8.04 (i386/x64)

• Ubuntu 9.04 (i386/x64)

• Fedora 11 (i386/x64)

MySQL Workbench also has the following general requirements:

1. The Microsoft .NET 3.5 Framework.

2. Cairo 1.6.0 or later

3. glib-2.10

4. libxml-2.6

5. libsigc++ 2.0

6. pcre

7. libzip

For convenience the Windows libraries are available as the download “Dependencies for Compiling in Windows”.

On start up, the application checks the OpenGL version and selects between software and hardware rendering. To determine the rendering method that is being used, open the Help menu and choose the System Info submenu.

The procedure for launching MySQL Workbench depends on the platform. Generally, there are two ways to launch MySQL Workbench from the command line and from the graphical user interface of the host operating system. Using the command-line launching facility is useful when you want to customize some aspects of the way MySQL Workbench operates. Launching MySQL Workbench for each of the supported platforms is described in the following sections.

In addition to platform-specific command line options, MySQL Workbench has the following command line options:

• --admin instance - Launch MySQL Workbench and load the server instance specified.

• --query connection - Launch MySQL Workbench and load the connection specified.

• --model modelfile - Launch MySQL Workbench and load the model specified.

• --script script - Launch MySQL Workbench and run the script specified.

• --run code - Launch MySQL Workbench and run the code snippet specified.

• --quit-when-done - quits MySQL Workbench after --script or --run finishes.

MySQL Workbench may be installed using the Windows installer file or it may be installed manually from a ZIP file.

Installing MySQL Workbench Using the Installer

MySQL Workbench can be installed using the Windows Installer (.msi) installation package. The MSI package bears the name mysql-workbench-version-win32.msi, where version indicates the MySQL Workbench version number.

Installing MySQL Workbench using the installer requires either Administrator or Power User privileges. If you are using the ZIP file without an installer, you do not need Administrator or Power User privileges.

Improving the MySQL Installation Wizard depends on the support and feedback of users. If you find that the MySQL Installation Wizard is lacking some feature important to you, or if you discover a bug, please report it in our bugs database. To do this use the Report a Bug option under the Help menu.

1. To install MySQL Workbench, right-click the MSI file and select the Install option from the pop-up menu, or simply double-click the file.

2. In the Setup Type window you may choose a Complete or Custom installation. To use all features of MySQL Workbench choose the Complete option.

3. Unless you choose otherwise, MySQL Workbench is installed in C:%PROGRAMFILES%MySQLMySQL Workbench 5.1 edition_type, where %PROGRAMFILES% is the default directory for programs for your locale. The %PROGRAMFILES% directory may be C:Program Files or C:programme.

Installing from the ZIP File

If you are having problems running the installer, as an alternative, you can download a ZIP file without an installer. That file is called mysql-workbench-version-win32.zip. Using a ZIP utility, unpack it to the directory of your choice. You may also want to create a shortcut on your desktop or the quick launch bar.

To install using the ZIP file, download the ZIP file to a convenient location and decompress the file. You can place the resulting directory anywhere on you system. You do not need to install or configure the application before using it.

To start MySQL Workbench on Windows select Start, Programs, MySQL and then select MySQL Workbench.

You may also start MySQL Workbench from the command line. To view the available command-line options, issue the command MySQLWorkbench -help | more from the MySQL Workbench installation directory. You will see the following output:

The MySQL Workbench version number is displayed followed by a usage message and then the options. Use the -swrendering option if your video card does not support OpenGL 1.5. The -version option can be used to display the MySQL Workbench version number. The -grtversion can be used to display the GRT shell version number. The other options are self-explanatory.

When using command-line options that display output to a console window, namely -help and -version, be sure that you pipe the output through the more command otherwise nothing will be displayed.

The method for uninstalling MySQL Workbench will depend on how you install MySQL Workbench in the first place.

Rmoving MySQL Workbench when installed Using the Installer

1. To uninstall MySQL Workbench, open the Control Panel and Choose Add or Remove Programs. Find the MySQL Workbench entry and choose the button. Doing this will remove MySQL Workbench.

2. Any modules added to the C:Program FilesMySQLMySQL Workbench versionmodules directory will not be deleted.

It is not possible to remove MySQL Workbench from the command line if you have installed MySQL Workbench using the installer. Although you can manually remove some of the compoentns There is no command-line option for removing MySQL Workbench.

Removing the MySQL Workbench directory manually will not remove all the files belonging to MySQL Workbench.

When installed from a ZIP file

If you installed MySQL Workbench using a ZIP file, to remove MySQL Workbench you can just delete the MySQL Workbench directory.

If you installed any additional modules within the modules directory and you want to keep them, make sure you copy those modules to a different directory before deleting the MySQL Workbench directory.

There are several binary distributions of MySQL Workbench available for Linux. These include:

• Fedora 10 amd64 (RPM)

• Ubuntu 8.04 i386 (DEB)

• Ubuntu 8.10 amd64 (DEB)

In addition to the binary distributions, it is also possible to download the MySQL Workbench source code as a tar.gz or RPM package.

Check the MySQL Workbench download page for the latest packages.

The procedure for installing on Linux depends on which Linux distribution you are using.

Installing DEB packages

On Ubuntu, and other systems that use the Debian package scheme, you can install MySQL Workbench using a command such as:

Note that package.deb will be the MySQL Workbench package, for example, mysql-workbench-oss-version_i386.deb, where version is the MySQL Workbench version number.

You may be warned that certain libraries are not available, depending on what you already have installed. Install the required libraries and then install the MySQL Workbench package again.

Installing RPM packages

On RedHat-based systems, and other systems using the RPM package format, MySQL Workbench can be installed by a command such as:

Again, note that package.rpm will be the MySQL Workbench package, for example, mysql-workbench-oss-version-1fc10.x86_64.rpm, and version is the MySQL Workbench version number.

Once MySQL Workbench has been installed it can be launched by selecting Applications, Programming, MySQL Workbench from the main menu.

MySQL Workbench can also be launched from the command line on Linux. Type the command:

This will display the available command-line options:

The procedure for uninstalling MySQL Workbench on Linux depends on the packe you are using.

Install Mysql On Mac

Uninstalling DEB packages

For Debian packages the command is:

This does not remove the configuration files. If you wish to also remove the configuration files use:

Uninstalling RPM packages

To uninstall RPM packages use:

This does not remove the configuration files.

MySQL Workbench is available for Mac OS X and is distributed as a DMG file. The file is named mysql-workbench-oss-version-osx10.5-i686.dmg, where version is the MySQL Workbench version.

To install MySQL Workbench on Mac OS X, simply download the file. Double-click the downloaded file. You will be presented with the installation screen:

Figure 3.1. MySQL Workbench Mac OS X Installation Screen

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

You can now launch MySQL Workbench from the Applications folder.

To launch MySQL Workbench on Mac OS X, simply open the Applications folder in the Finder, then double-click MySQL Workbench.

It is also possible to start MySQL Workbench from the command line:

Download Mysql Database For Windows

A model file must be specified.

Mysql For Mac

To uninstall MySQL Workbench for Mac OS X, simply locate MySQL Workbench in the Applications folder, right-click, and select Move to Trash. The application is uninstalled.