<div id="docs-body">
 <div class="section">
  <div class="titlepage">
   <div>
    <div>
     <h3 class="title">
      <a name="macos-installation-prefpane">
      </a>
      2.4.4 Installing 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-initial">
   </a>
   <p class="title">
    <b>
     Figure 2.8 MySQL Preference Pane: Location
    </b>
   </p>
   <div class="figure-contents">
    <div class="mediaobject">
     <img alt='Shows "MySQL" typed into the macOS System Preferences search box, and a highlighted "MySQL" icon in the bottom left.' src="images/mac-installer-preference-pane-location.png" style="width: 100%; max-width: 668px;"/>
    </div>
   </div>
  </div>
  <br class="figure-break"/>
  <p>
   The MySQL preference pane is installed with the same DMG file that
      installs MySQL Server. Typically it is installed with MySQL Server
      but it can be installed by itself too.
  </p>
  <p>
   To install the MySQL preference pane:
  </p>
  <div class="orderedlist">
   <ol class="orderedlist" type="1">
    <li class="listitem">
     <p>
      Go through the process of installing the MySQL server, as
          described in the documentation at
      <a class="xref" href="macos-installation-pkg.html" title="2.4.2 Installing MySQL on macOS Using Native Packages">
       Section 2.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. The other options, such as MySQL Server,
          can be selected or deselected.
     </p>
     <div class="figure">
      <a name="mac-installer-installation-customize-pane">
      </a>
      <p class="title">
       <b>
        Figure 2.9 MySQL Package Installer Wizard: Customize
       </b>
      </p>
      <div class="figure-contents">
       <div class="mediaobject">
        <img alt="Customize shows three package name options: MySQL Server, MySQL Test, Preference Pane, and Launchd Support. All three options are checked." src="images/mac-installer-installation-type-customize.png" style="width: 100%; max-width: 688px;"/>
       </div>
      </div>
     </div>
     <br class="figure-break"/>
    </li>
    <li class="listitem">
     <p>
      Complete the 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 this preference pane.
  </p>
  <p>
   The
   <span class="guilabel">
    Instances
   </span>
   page includes an option to
      start or stop MySQL, and
   <span class="guibutton">
    Initialize
      Database
   </span>
   recreates the
   <code class="filename">
    data/
   </code>
   directory.
   <span class="guibutton">
    Uninstall
   </span>
   uninstalls MySQL
      Server and optionally the MySQL preference panel and launchd
      information.
  </p>
  <div class="figure">
   <a name="mac-installer-preference-pane-instances-instances">
   </a>
   <p class="title">
    <b>
     Figure 2.10 MySQL Preference Pane: Instances
    </b>
   </p>
   <div class="figure-contents">
    <div class="mediaobject">
     <img alt='The left side shows a list of MySQL instances separated by "Active Instance", "Installed Instances", and "Data Directories" sections. The right side shows a "Stop MySQL Server" button, a check box titled "Start MySQL when your computer starts up", and "Initialize Database" and "Uninstall" buttons.' src="images/mac-installer-preference-pane-instances.png" style="width: 100%; max-width: 780px;"/>
    </div>
   </div>
  </div>
  <br class="figure-break"/>
  <p>
   The
   <span class="guilabel">
    Configuration
   </span>
   page shows MySQL Server
      options including the path to the MySQL configuration file.
  </p>
  <div class="figure">
   <a name="mac-installer-preference-pane-configuration">
   </a>
   <p class="title">
    <b>
     Figure 2.11 MySQL Preference Pane: Configuration
    </b>
   </p>
   <div class="figure-contents">
    <div class="mediaobject">
     <img alt="Content is described in the surrounding text." src="images/mac-installer-preference-pane-configuration.png" style="width: 100%; max-width: 780px;"/>
    </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>
 <br/>
</div>
