This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>2.4Installing MySQL on macOS</title><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="osx-installation"></a>2.4Installing MySQL on macOS</h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="#osx-installation-notes">2.4.1 General Notes on Installing MySQL on macOS</a></span></dt><dt><span class="section"><a href="#osx-installation-pkg">2.4.2 Installing MySQL on macOS Using Native Packages</a></span></dt><dt><span class="section"><a href="#osx-installation-launchd">2.4.3 Installing a MySQL Launch Daemon</a></span></dt><dt><span class="section"><a href="#osx-installation-prefpane">2.4.4 Installing and Using the MySQL Preference Pane</a></span></dt></dl></div><a class="indexterm" name="idm139880410066048"></a><a class="indexterm" name="idm139880410064592"></a><p>
For a list of macOS versions that the MySQL server supports, see
<a class="ulink" href="https://www.mysql.com/support/supportedplatforms/database.html" target="_top">https://www.mysql.com/support/supportedplatforms/database.html</a>.
</p><p>
MySQL for macOS is available in a number of different forms:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
Native Package Installer, which uses the native macOS installer
(DMG) to walk you through the installation of MySQL. For more
information, see <a class="xref" href="#osx-installation-pkg" title="2.4.2Installing MySQL on macOS Using Native Packages">Section2.4.2, “Installing MySQL on macOS Using Native Packages”</a>. You can
use the package installer with macOS. The user you use to
perform the installation must have administrator privileges.
</p></li><li class="listitem"><p>
Compressed TAR archive, which uses a file packaged using the
Unix <span class="command"><strong>tar</strong></span> and <span class="command"><strong>gzip</strong></span>
commands. To use this method, you will need to open a
<span class="command"><strong>Terminal</strong></span> window. You do not need
administrator privileges using this method, as you can install
the MySQL server anywhere using this method. For more
information on using this method, you can use the generic
instructions for using a tarball,
<a class="xref" href="#binary-installation" title="2.2Installing MySQL on Unix/Linux Using Generic Binaries">Section2.2, “Installing MySQL on Unix/Linux Using Generic Binaries”</a>.
</p><p>
In addition to the core installation, the Package Installer also
includes <a class="xref" href="#osx-installation-launchd" title="2.4.3Installing a MySQL Launch Daemon">Section2.4.3, “Installing a MySQL Launch Daemon”</a> and
<a class="xref" href="#osx-installation-prefpane" title="2.4.4Installing and Using the MySQL Preference Pane">Section2.4.4, “Installing and Using the MySQL Preference Pane”</a>, both of which
simplify the management of your installation.
</p></li></ul></div><p>
For additional information on using MySQL on macOS, see
<a class="xref" href="#osx-installation-notes" title="2.4.1General Notes on Installing MySQL on macOS">Section2.4.1, “General Notes on Installing MySQL on macOS”</a>.
</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="osx-installation-notes"></a>2.4.1General Notes on Installing MySQL on macOS</h3></div></div></div><p>
You should keep the following issues and notes in mind:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
As of macOS 10.14 (Majave), the macOS MySQL 5.7 Installer
application requires permission to control <span class="emphasis"><em>System
Events</em></span> so it can display a generated (temporary)
MySQL root password. Choosing "Don't Allow" means this
password won't be visible for use.
</p><p>
If previously disallowed, the fix is enabling <span class="emphasis"><em>System
Events.app</em></span> for <span class="emphasis"><em>Installer.app</em></span>
under the <span class="emphasis"><em>Security & Privacy</em></span> |
<span class="emphasis"><em>Automation</em></span> | <span class="emphasis"><em>Privacy</em></span>
tab.
</p></li><li class="listitem"><p>
A launchd daemon is installed, and it includes MySQL
configuration options. Consider editing it if needed, see the
documentation below for additional information. Also, macOS
10.10 removed startup item support in favor of launchd
daemons. The optional MySQL preference pane under macOS
<span class="guilabel">System Preferences</span> uses the launchd
daemon.
</p></li><li class="listitem"><p>
You may need (or want) to create a specific
<code class="literal">mysql</code> user to own the MySQL directory and
data. You can do this through the <span class="command"><strong>Directory
Utility</strong></span>, and the <code class="literal">mysql</code> user
should already exist. For use in single user mode, an entry
for <code class="literal">_mysql</code> (note the underscore prefix)
should already exist within the system
<code class="filename">/etc/passwd</code> file.
</p></li><li class="listitem"><p>
Because the MySQL package installer installs the MySQL
contents into a version and platform specific directory, you
can use this to upgrade and migrate your database between
versions. You will need to either copy the
<code class="filename">data</code> directory from the old version to
the new version, or alternatively specify an alternative
<code class="option">datadir</code> value to set location of the data
directory. By default, the MySQL directories are installed
under <code class="filename">/usr/local/</code>.
</p></li><li class="listitem"><p>
You might want to add aliases to your shell's resource file to
make it easier to access commonly used programs such as
<a class="link" href="#mysql" title="4.5.1mysql — The MySQL Command-Line Client"><span class="command"><strong>mysql</strong></span></a> and <a class="link" href="#mysqladmin" title="4.5.2mysqladmin — Client for Administering a MySQL Server"><span class="command"><strong>mysqladmin</strong></span></a>
from the command line. The syntax for <span class="command"><strong>bash</strong></span>
is:
</p><pre data-lang="terminal" class="programlisting">
alias mysql=/usr/local/mysql/bin/mysql
alias mysqladmin=/usr/local/mysql/bin/mysqladmin
</pre><p>
For <span class="command"><strong>tcsh</strong></span>, use:
</p><pre data-lang="terminal" class="programlisting">
alias mysql /usr/local/mysql/bin/mysql
alias mysqladmin /usr/local/mysql/bin/mysqladmin
</pre><p>
Even better, add <code class="literal">/usr/local/mysql/bin</code> to
your <code class="literal">PATH</code> environment variable. You can do
this by modifying the appropriate startup file for your shell.
For more information, see <a class="xref" href="#invoking-programs" title="4.2.1Invoking MySQL Programs">Section4.2.1, “Invoking MySQL Programs”</a>.
</p></li><li class="listitem"><p>
After you have copied over the MySQL database files from the
previous installation and have successfully started the new
server, you should consider removing the old installation
files to save disk space. Additionally, you should also remove
older versions of the Package Receipt directories located in
<code class="filename">/Library/Receipts/mysql-<em class="replaceable"><code>VERSION</code></em>.pkg</code>.
</p></li><li class="listitem"><p>
Prior to OS X 10.7, MySQL server was bundled with OS X Server.
</p></li></ul></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="osx-installation-pkg"></a>2.4.2Installing MySQL on macOS Using Native Packages</h3></div></div></div><p>
The package is located inside a disk image
(<code class="literal">.dmg</code>) 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.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
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
<a class="link" href="#mysqladmin" title="4.5.2mysqladmin — Client for Administering a MySQL Server"><span class="command"><strong>mysqladmin shutdown</strong></span></a> on the command line.
</p></div><p>
To install MySQL using the package installer:
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
Download the disk image (<code class="filename">.dmg</code>) file (the
community version is available
<a class="ulink" href="https://dev.mysql.com/downloads/mysql/" target="_top">here</a>) that
contains the MySQL package installer. Double-click the file to
mount the disk image and see its contents.
</p><div class="figure"><a name="mac-installer-dmg-contents"></a><p class="title"><b>Figure2.19MySQL Package Installer: DMG Contents</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-dmg-contents.png" width="428" height="382" alt="Mounted macOS disk image contents that contains the MySQL Server package file."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
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.28 it might be
named
<code class="filename">mysql-5.7.28-osx-<em class="replaceable"><code>10.13-x86_64</code></em>.pkg</code>.
</p></li><li class="listitem"><p>
The initial wizard introduction screen references the MySQL
server version to install. Click
<span class="guibutton">Continue</span> to begin the installation.
</p><div class="figure"><a name="mac-installer-dmg-introduction"></a><p class="title"><b>Figure2.20MySQL Package Installer Wizard: Introduction</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-dmg-introduction.png" width="732" height="550" alt="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."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
The MySQL community edition shows a copy of the relevant GNU
General Public License. Click <span class="guibutton">Continue</span>
and then <span class="guibutton">Agree</span> to continue.
</p></li><li class="listitem"><p>
From the <span class="guilabel">Installation Type</span> page you can
either click <span class="guibutton">Install</span> to execute the
installation wizard using all defaults, click
<span class="guibutton">Customize</span> to alter which components to
install (MySQL server, Preference Pane, Launchd Support -- all
enabled by default).
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
Although the <span class="guibutton">Change Install Location</span>
option is visible, the installation location cannot be
changed.
</p></div><div class="figure"><a name="mac-installer-installation-type-main"></a><p class="title"><b>Figure2.21MySQL Package Installer Wizard: Installation Type</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-installation-type.png" width="732" height="550" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><div class="figure"><a name="mac-installer-installation-customize-main"></a><p class="title"><b>Figure2.22MySQL Package Installer Wizard: Customize</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-installation-customize.png" width="732" height="550" alt="Customize shows three package name options: MySQL Server, Preference Pane, and Launchd Support. All three options are checked."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
Click <span class="guibutton">Install</span> to begin the installation
process.
</p></li><li class="listitem"><p>
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:
</p><div class="figure"><a name="mac-installer-installation-root-password"></a><p class="title"><b>Figure2.23MySQL Package Installer Wizard: Temporary Root Password</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-root-password.png" width="600" height="316" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
MySQL expires this temporary root password after the initial
login and requires you to create a new password.
</p></div></li><li class="listitem"><p>
<span class="guilabel">Summary</span> is the final step and references
a successful and complete MySQL Server installation.
<span class="guibutton">Close</span> the wizard.
</p><div class="figure"><a name="mac-installer-installation-summary"></a><p class="title"><b>Figure2.24MySQL Package Installer Wizard: Summary</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-summary.png" width="732" height="550" alt="Shows that the installation was a success, and includes links to the MySQL manual, mysql.com, and oracle.com."></div></div></div><br class="figure-break"></li></ol></div><p>
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
<a class="xref" href="#osx-installation-launchd" title="2.4.3Installing a MySQL Launch Daemon">Section2.4.3, “Installing a MySQL Launch Daemon”</a>, and
<a class="xref" href="#osx-installation-prefpane" title="2.4.4Installing and Using the MySQL Preference Pane">Section2.4.4, “Installing and Using the MySQL Preference Pane”</a>. Use the MySQL
Preference Pane or launchd to configure MySQL to automatically
start at bootup.
</p><p>
When installing using the package installer, the files are
installed into a directory within <code class="filename">/usr/local</code>
matching the name of the installation version and platform. For
example, the installer file
<code class="filename">mysql-5.7.28-<em class="replaceable"><code>osx10.13-x86_64.dmg</code></em></code>
installs MySQL into
<code class="filename">/usr/local/mysql-5.7.28-osx10.13-x86_64/
</code>. The following table shows the layout of the
installation directory.
</p><div class="table"><a name="mysql-installation-layout-osx"></a><p class="title"><b>Table2.6MySQL Installation Layout on macOS</b></p><div class="table-contents"><table><col width="45%"><col width="55%"><thead><tr>
<th scope="col">Directory</th>
<th scope="col">Contents of Directory</th>
</tr></thead><tbody><tr>
<td scope="row"><code class="filename">bin</code></td>
<td><a class="link" href="#mysqld" title="4.3.1mysqld — The MySQL Server"><span class="command"><strong>mysqld</strong></span></a> server, client and utility programs</td>
</tr><tr>
<td scope="row"><code class="filename">data</code></td>
<td>Log files, databases</td>
</tr><tr>
<td scope="row"><code class="filename">docs</code></td>
<td>Helper documents, like the Release Notes and build information</td>
</tr><tr>
<td scope="row"><code class="filename">include</code></td>
<td>Include (header) files</td>
</tr><tr>
<td scope="row"><code class="filename">lib</code></td>
<td>Libraries</td>
</tr><tr>
<td scope="row"><code class="filename">man</code></td>
<td>Unix manual pages</td>
</tr><tr>
<td scope="row"><code class="filename">mysql-test</code></td>
<td>MySQL test suite</td>
</tr><tr>
<td scope="row"><code class="filename">share</code></td>
<td>Miscellaneous support files, including error messages, sample
configuration files, SQL for database installation</td>
</tr><tr>
<td scope="row"><code class="filename">support-files</code></td>
<td>Scripts and sample configuration files</td>
</tr><tr>
<td scope="row"><code class="filename">/tmp/mysql.sock</code></td>
<td>Location of the MySQL Unix socket</td>
</tr></tbody></table></div></div><br class="table-break"><p>
During the package installer process, a symbolic link from
<code class="filename">/usr/local/mysql</code> to the version/platform
specific directory created during installation will be created
automatically.
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="osx-installation-launchd"></a>2.4.3Installing a MySQL Launch Daemon</h3></div></div></div><p>
macOS uses launch daemons to automatically start, stop, and manage
processes and applications such as MySQL.
</p><p>
By default, the installation package (DMG) on macOS installs a
launchd file named
<code class="filename">/Library/LaunchDaemons/com.oracle.oss.mysql.mysqld.plist</code>
that contains a plist definition similar to:
</p><pre data-lang="terminal" class="programlisting">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key> <string>com.oracle.oss.mysql.mysqld</string>
<key>ProcessType</key> <string>Interactive</string>
<key>Disabled</key> <false/>
<key>RunAtLoad</key> <true/>
<key>KeepAlive</key> <true/>
<key>SessionCreate</key> <true/>
<key>LaunchOnlyOnce</key> <false/>
<key>UserName</key> <string>_mysql</string>
<key>GroupName</key> <string>_mysql</string>
<key>ExitTimeOut</key> <integer>600</integer>
<key>Program</key> <string>/usr/local/mysql/bin/mysqld</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/mysql/bin/mysqld</string>
<string>--user=_mysql</string>
<string>--basedir=/usr/local/mysql</string>
<string>--datadir=/usr/local/mysql/data</string>
<string>--plugin-dir=/usr/local/mysql/lib/plugin</string>
<string>--log-error=/usr/local/mysql/data/mysqld.local.err</string>
<string>--pid-file=/usr/local/mysql/data/mysqld.local.pid</string>
</array>
<key>WorkingDirectory</key> <string>/usr/local/mysql</string>
</dict>
</plist>
</pre><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
Some users report that adding a plist DOCTYPE declaration causes
the launchd operation to fail, despite it passing the lint
check. We suspect it's a copy-n-paste error. The md5 checksum of
a file containing the above snippet is
<span class="emphasis"><em>24710a27dc7a28fb7ee6d825129cd3cf</em></span>.
</p></div><p>
To enable the launchd service, you can either:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
Click <span class="guibutton">Start MySQL Server</span> from the MySQL
preference pane.
</p><div class="figure"><a name="mac-installer-preference-pane-location-start"></a><p class="title"><b>Figure2.25MySQL Preference Pane: Location</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-preference-pane-location.png" width="800" height="746" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><div class="figure"><a name="mac-installer-preference-pane-usage"></a><p class="title"><b>Figure2.26MySQL Preference Pane: Usage</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-preference-pane-usage.png" width="780" height="426" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
Or, manually load the launchd file.
</p><pre data-lang="terminal" class="programlisting">
shell> cd /Library/LaunchDaemons
shell> sudo launchctl load -F com.oracle.oss.mysql.mysqld.plist
</pre></li><li class="listitem"><p>
To configure MySQL to automatically start at bootup, you can:
</p><pre data-lang="terminal" class="programlisting">
shell> sudo launchctl load -w com.oracle.oss.mysql.mysqld.plist
</pre></li></ul></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
When upgrading MySQL server, the launchd installation process
will remove the old startup items that were installed with MySQL
server 5.7.7 and below.
</p><p>
Also, upgrading will replace your existing launchd file of the
same name.
</p></div><p>
Additional launchd related information:
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
The plist entries override <code class="filename">my.cnf</code>
entries, because they are passed in as command line arguments.
For additional information about passing in program options,
see <a class="xref" href="#program-options" title="4.2.2Specifying Program Options">Section4.2.2, “Specifying Program Options”</a>.
</p></li><li class="listitem"><p>
The <span class="bold"><strong>ProgramArguments</strong></span> section
defines the command line options that are passed into the
program, which is the <code class="filename">mysqld</code> binary in
this case.
</p></li><li class="listitem"><p>
The default plist definition is written with less
sophisticated use cases in mind. For more complicated setups,
you may want to remove some of the arguments and instead rely
on a MySQL configuration file, such as
<code class="filename">my.cnf</code>.
</p></li><li class="listitem"><p>
If you edit the plist file, then uncheck the installer option
when reinstalling or upgrading MySQL. Otherwise, your edited
plist file will be overwritten, and all edits will be lost.
</p></li></ul></div><p>
Because the default plist definition defines several
<span class="bold"><strong>ProgramArguments</strong></span>, you might
remove most of these arguments and instead rely upon your
<code class="filename">my.cnf</code> MySQL configuration file to define
them. For example:
</p><pre data-lang="terminal" class="programlisting">
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key> <string>com.oracle.oss.mysql.mysqld</string>
<key>ProcessType</key> <string>Interactive</string>
<key>Disabled</key> <false/>
<key>RunAtLoad</key> <true/>
<key>KeepAlive</key> <true/>
<key>SessionCreate</key> <true/>
<key>LaunchOnlyOnce</key> <false/>
<key>UserName</key> <string>_mysql</string>
<key>GroupName</key> <string>_mysql</string>
<key>ExitTimeOut</key> <integer>600</integer>
<key>Program</key> <string>/usr/local/mysql/bin/mysqld</string>
<key>WorkingDirectory</key> <string>/usr/local/mysql</string>
<key>ProgramArguments</key>
<array>
<string>/usr/local/mysql/bin/mysqld</string>
<string>--user=_mysql</string>
</array>
</dict>
</plist>
</pre><p>
In this case, the <a class="link" href="#sysvar_basedir"><code class="literal">basedir</code></a>,
<a class="link" href="#sysvar_datadir"><code class="literal">datadir</code></a>,
<a class="link" href="#sysvar_plugin_dir"><code class="literal">plugin_dir</code></a>,
<a class="link" href="#sysvar_log_error"><code class="literal">log_error</code></a>, and
<a class="link" href="#sysvar_pid_file"><code class="literal">pid_file</code></a> options were removed
from the plist definition, and then you you might define them in
<code class="filename">my.cnf</code>.
</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="osx-installation-prefpane"></a>2.4.4Installing and Using the MySQL Preference Pane</h3></div></div></div><p>
The MySQL Installation Package includes a MySQL preference pane
that enables you to start, stop, and control automated startup
during boot of your MySQL installation.
</p><p>
This preference pane is installed by default, and is listed under
your system's <span class="emphasis"><em>System Preferences</em></span> window.
</p><div class="figure"><a name="mac-installer-preference-pane-location-start-2"></a><p class="title"><b>Figure2.27MySQL Preference Pane: Location</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-preference-pane-location.png" width="800" height="746" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><p>
To install the MySQL Preference Pane:
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
Download the disk image (<code class="filename">.dmg</code>) file (the
community version is available
<a class="ulink" href="https://dev.mysql.com/downloads/mysql/" target="_top">here</a>) that
contains the MySQL package installer. Double-click the file to
mount the disk image and see its contents.
</p><div class="figure"><a name="mac-installer-dmg-contents-prefpane"></a><p class="title"><b>Figure2.28MySQL Package Installer: DMG Contents</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-dmg-contents.png" width="428" height="382" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
Go through the process of installing the MySQL server, as
described in the documentation at
<a class="xref" href="#osx-installation-pkg" title="2.4.2Installing MySQL on macOS Using Native Packages">Section2.4.2, “Installing MySQL on macOS Using Native Packages”</a>.
</p></li><li class="listitem"><p>
Click <span class="guibutton">Customize</span> at the
<span class="guilabel">Installation Type</span> step. The "Preference
Pane" option is listed there and enabled by default; make sure
it is not deselected.
</p><div class="figure"><a name="mac-startup-installer-customize-prefpane"></a><p class="title"><b>Figure2.29MySQL Installer on macOS: Customize</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-installation-customize.png" width="732" height="550" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"></li><li class="listitem"><p>
Complete the MySQL server installation process.
</p></li></ol></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><div class="admon-title">Note</div><p>
The MySQL preference pane only starts and stops MySQL
installation installed from the MySQL package installation that
have been installed in the default location.
</p></div><p>
Once the MySQL preference pane has been installed, you can control
your MySQL server instance using the preference pane. To use the
preference pane, open the <span class="guilabel">System
Preferences...</span> from the Apple menu. Select the MySQL
preference pane by clicking the MySQL icon within the preference
panes list.
</p><div class="figure"><a name="mac-installer-preference-pane-location"></a><p class="title"><b>Figure2.30MySQL Preference Pane: Location</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-preference-pane-location.png" width="800" height="746" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><div class="figure"><a name="mac-installer-preference-pane-usage-3"></a><p class="title"><b>Figure2.31MySQL Preference Pane: Usage</b></p><div class="figure-contents"><div class="mediaobject"><img src="../refman-common/images/published/mac-installer-preference-pane-usage.png" width="780" height="426" alt="Content is described in the surrounding text."></div></div></div><br class="figure-break"><p>
The MySQL Preference Pane shows the current status of the MySQL
server, showing <span class="guilabel">stopped</span> (in red) if the
server is not running and <span class="guilabel">running</span> (in green)
if the server has already been started. The preference pane also
shows the current setting for whether the MySQL server has been
set to start automatically.
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
<span class="bold"><strong>To start the MySQL server using the
preference pane: </strong></span>
</p><p>
Click <span class="guibutton">Start MySQL Server</span>. You may be
prompted for the username and password of a user with
administrator privileges to start the MySQL server.
</p></li><li class="listitem"><p>
<span class="bold"><strong>To stop the MySQL server using the
preference pane: </strong></span>
</p><p>
Click <span class="guibutton">Stop MySQL Server</span>. You may be
prompted for the username and password of a user with
administrator privileges to stop the MySQL server.
</p></li><li class="listitem"><p>
<span class="bold"><strong>To automatically start the MySQL server
when the system boots:</strong></span>
</p><p>
Check the check box next to <span class="guilabel">Automatically Start
MySQL Server on Startup</span>.
</p></li><li class="listitem"><p>
<span class="bold"><strong>To disable automatic MySQL server
startup when the system boots:</strong></span>
</p><p>
Uncheck the check box next to <span class="guilabel">Automatically Start
MySQL Server on Startup</span>.
</p></li></ul></div><p>
You can close the <span class="command"><strong>System Preferences...</strong></span> window
once you have completed your settings.
</p></div></div><div class="copyright-footer"></div></body></html>
