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) 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.5, “Installing and Using the MySQL Preference Pane”.
When installing using the package installer, the files are
installed into a directory within
matching the name of the installation version and platform. For
example, the installer file
installs MySQL into
. The following table shows the layout of the
Table 2.8 MySQL Installation Layout on OS X
|Directory||Contents of Directory|
|mysqld server, client and utility programs|
|Log files, databases|
|Helper documents, like the Release Notes and build information|
|Include (header) files|
|Unix manual pages|
|MySQL test suite|
|Miscellaneous support files, including error messages, sample configuration files, SQL for database installation|
|Scripts and sample configuration files|
|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 will be created
Download and open the MySQL package installer, which is
provided on a disk image (
includes the main MySQL installation package file.
Double-click the disk image to open it.
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
You will be presented with the opening installer dialog. Click Continue to begin installation.
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.
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, Startup Item, Preference Pane -- 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.
OS X 10.4 deprecated startup items in favor of launchd daemons, and as of OS X 10.10 (Yosemite), startup items do not function. For these reasons, launchd daemons are preferred over startup items.
Click Install to begin the installation process.
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.
For convenience, you may also want to install a launch daemon and preference pane. See Section 2.4.3, “Installing a MySQL Launch Daemon”, and Section 2.4.5, “Installing and Using the MySQL Preference Pane”.