Documentation Home
MySQL 5.5 Reference Manual
Related Documentation Download this Manual Excerpts from this Manual

MySQL 5.5 Reference Manual  /  ...  /  Installing MySQL on OS X Using Native Packages

2.4.2 Installing MySQL on OS X 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.


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

When installing from the package version, you can also install the MySQL preference pane, which will enable you to control the startup and execution of your MySQL server from System Preferences. For more information, see Section 2.4.4, “Installing and Using the MySQL Preference Pane”.

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.5.48-osx10.9-x86_64.dmg installs MySQL into /usr/local/mysql-5.5.48-osx10.9-x86_64/ . The following table shows the layout of the installation directory.

Table 2.8 MySQL Installation Layout on OS X

DirectoryContents of Directory
bin, scriptsmysqld server, client and utility programs
dataLog files, databases
docsHelper documents, like the Release Notes and build information
includeInclude (header) files
manUnix manual pages
mysql-testMySQL test suite
shareMiscellaneous support files, including error messages, sample configuration files, SQL for database installation
support-filesScripts and sample configuration files
/tmp/mysql.sockLocation 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 will be created automatically.

  1. Download and open the MySQL package installer, which is provided on a disk image (.dmg) that includes the main MySQL installation package file. Double-click the disk image to open it.

    Figure 2.41 MySQL Package Installer: DMG Contents

    MySQL Package Installer: DMG Contents

  2. Double-click the MySQL installer package. It will be named according to the version of MySQL you have downloaded. For example, if you have downloaded MySQL server 5.5.48, double-click mysql-5.5.48-osx-10.9-x86_64.pkg.

  3. You will be presented with the opening installer dialog. Click Continue to begin installation.

    Figure 2.42 MySQL Package Installer: Introduction

    MySQL Package Installer: Introduction

  4. If you have downloaded the community version of MySQL, you will be shown 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), or click Change Installation Location to change the type of installation for either all users, only the user executing the Installer, or define a custom location.

    Figure 2.43 MySQL Package Installer: Installation Type

    MySQL Package Installer: Installation Type

    Figure 2.44 MySQL Package Installer: Destination Select (Change Installation Location)

    MySQL Package Installer: Destination Select (Change Installation Location)

    Figure 2.45 MySQL Package Installer: Customize

    MySQL Package Installer: Customize

  6. Click Install to begin the installation process.

  7. Once the installation has been completed successfully, you will be shown an Install Succeeded message with a short summary. Now, Close the wizard and begin using the MySQL server.

    Figure 2.46 MySQL Package Installer: Summary

    MySQL Package Installer: Summary

MySQL server is now installed, but it is not loaded (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”.

Download this Manual
User Comments
Sign Up Login You must be logged in to post a comment.