Documentation Home
MySQL 5.7 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 35.0Mb
PDF (A4) - 35.1Mb
Man Pages (TGZ) - 255.4Kb
Man Pages (Zip) - 360.2Kb
Info (Gzip) - 3.4Mb
Info (Zip) - 3.4Mb
Excerpts from this Manual

MySQL 5.7 Reference Manual  /  ...  /  Installing MySQL on macOS Using Native Packages

2.4.2 Installing MySQL on macOS Using Native Packages

The package is located inside a disk image (.dmg) file that you first need to mount by double-clicking its icon in the Finder. It should then mount the image and display its contents.

Note

Before proceeding with the installation, be sure to stop all running MySQL server instances by using either the MySQL Manager Application (on macOS Server), the preference pane, or mysqladmin shutdown on the command line.

To install MySQL using the package installer:

  1. Download the disk image (.dmg) file (the community version is available here) that contains the MySQL package installer. Double-click the file to mount the disk image and see its contents.

    Figure 2.13 MySQL Package Installer: DMG Contents

    Mounted macOS disk image contents that contains the MySQL Server package file.

  2. Double-click the MySQL installer package from the disk. It is named according to the version of MySQL you have downloaded. For example, for MySQL server 5.7.44 it might be named mysql-5.7.44-macos-10.13-x86_64.pkg.

  3. The initial wizard introduction screen references the MySQL server version to install. Click Continue to begin the installation.

    Figure 2.14 MySQL Package Installer Wizard: Introduction

    Shows that the installation is ready to start, the MySQL server version being installed, and includes links to the MySQL manual, mysql.com, and oracle.com.

  4. The MySQL community edition shows a copy of the relevant GNU General Public License. Click Continue and then Agree to continue.

  5. From the Installation Type page you can either click Install to execute the installation wizard using all defaults, click Customize to alter which components to install (MySQL server, Preference Pane, Launchd Support -- all enabled by default).

    Note

    Although the Change Install Location option is visible, the installation location cannot be changed.

    Figure 2.15 MySQL Package Installer Wizard: Installation Type

    Content is described in the surrounding text.

    Figure 2.16 MySQL Package Installer Wizard: Customize

    Customize shows three package name options: MySQL Server, Preference Pane, and Launchd Support. All three options are checked.

  6. Click Install to begin the installation process.

  7. After a successful installation, the installer displays a window with your temporary root password. This cannot be recovered so you must save this password for the initial login to MySQL. For example:

    Figure 2.17 MySQL Package Installer Wizard: Temporary Root Password

    Content is described in the surrounding text.

    Note

    MySQL expires this temporary root password after the initial login and requires you to create a new password.

  8. Summary is the final step and references a successful and complete MySQL Server installation. Close the wizard.

    Figure 2.18 MySQL Package Installer Wizard: Summary

    Shows that the installation was a success, and includes links to the MySQL manual, mysql.com, and oracle.com.

MySQL server is now installed, but it is not loaded (or started) by default. Use either launchctl from the command line, or start MySQL by clicking "Start" using the MySQL preference pane. For additional information, see Section 2.4.3, “Installing a MySQL Launch Daemon”, and Section 2.4.4, “Installing and Using the MySQL Preference Pane”. Use the MySQL Preference Pane or launchd to configure MySQL to automatically start at bootup.

When installing using the package installer, the files are installed into a directory within /usr/local matching the name of the installation version and platform. For example, the installer file mysql-5.7.44-macos10.13-x86_64.dmg installs MySQL into /usr/local/mysql-5.7.44-macos10.13-x86_64/ . The following table shows the layout of the installation directory.

Table 2.7 MySQL Installation Layout on macOS

Directory Contents of Directory
bin mysqld server, client and utility programs
data Log files, databases
docs Helper documents, like the Release Notes and build information
include Include (header) files
lib Libraries
man Unix manual pages
mysql-test MySQL test suite
share Miscellaneous support files, including error messages, sample configuration files, SQL for database installation
support-files Scripts and sample configuration files
/tmp/mysql.sock Location of the MySQL Unix socket

During the package installer process, a symbolic link from /usr/local/mysql to the version/platform specific directory created during installation is created automatically.