Installing MySQL Using the Native Installation Package. The free download for the Mac is the MySQL Community Server edition. Go to the MySQL website and download the latest version of MySQL for MacOS. Select the native package DMG archive version, not the compressed TAR version. Click the Download button next to the version you choose. At the OSX Terminal prompt you enter mysql-u root to actually start the command line client that connects to the server. Shell represents whatever your shell prompt actually looks like. You do not enter this in after you have already typed mysql at the command line prompt. Consequently, how do I run MySQL in terminal? Installing and Running MySQL on macOS / Mac OS X. The first step in setting up a MySQL database server on your Mac is to download the MySQL installer. MySQL offers a free edition called the MySQL Community Server. Click the link below to be taken to the download page for the MySQL Community Server.
In order to follow this guide, you should have a Mac computer with the Catalina OS installed.
I was using for several years MAMP, Fywheel, as well as package managers like brew, and all work pretty well, but why not using the preinstalled Apache and PHP that is shipped in almost all macOS?
In this tutorial, I will show you how to setup/install Apache, PHP, and MySQL on macOS Catalina.
Open the Terminal app and switch to the root user so you can run the commands in this post without any permission issues:
Enable Apache on macOS
Check if works by accessing:
Enable PHP for Apache
First, let’s make a backup of the default Apache configuration
Edit the Apache configuration
Uncomment the following line
You can verify PHP is enabled by creating a phpinfo() page in your DocumentRoot.
Execute Mysql Macos
The default DocumentRoot for macOS Catalina is /Library/WebServer/Documents. In order to verify this, we run the command below to find out our Apache configuration.
Create the phpinfo() page in your DocumentRoot:
Verify PHP by accessing http://localhost/phpinfo.php
Customizing PHP settings (php.ini)
MacOS’ PHP uses a default php.ini file based on /private/etc/php.ini.default.
To customize your PHP environment, if a php.ini file doesn’t already exist at /private/etc/php.ini, copy the default template to create a main php.ini file:
Make any changes you wish to php.ini and restart apache to reload all configuration files:
If you were to run phpinfo() in a PHP file from the web server, you should now see that the Loaded Configuration File property now has the value /etc/php.ini.
A very common tweak to the default PHP configuration is to allow larger file upload sizes. The post_max_size and upload_max_filesize properties are only a few megs by default. These limits can be raised as you see fit.
Many developers also tweak the max_execution_time, max_input_time, and memory_limit settings depending on their project.
Always remember to restart apache after making changes to your PHP configuration.
Install MySQL on macOS Catalina
Download and install the latest MySQL version for your macOS.
Open a new terminal and run the code below this will update the mysql path on your ~/.profile
Please run mysql_secure_installation to make your MySQL secured
Strong Password? Yes
Change the root password? Yes
Remove anonymous users? yes
Disallow root login remotely? Yes
Remove test database? Yes
Reload privileges tables now? Yes
We can set a command shortcut for mysql:
Now, to access mysql console, we can run below short command:
Useful mysql commands
Connect PHP and MySQL
Create symlink to ensure PHP and MySQL can communicate each other.
Edited my Apache Configuration:
Uncommented the following lines
Edit the Apache configuration file:
Add the below line after this included #Include /private/etc/apache2/extra/httpd-vhosts.conf
Create the apache2 vhosts directory.
Create the default virtual host configuration file.
Add the following configuration:
The default virtual host was created for when the Apache web server can’t find a virtual host, it will use this configuration. By prefixing this file with an underscore, Apache will include it first.
Now we can create our first virtual host. The example below contains the virtual host configuration for my test site.
Create the virtual host configuration file:
Add the following configuration:
This VirtualHost configuration allows me to access my site from http://nuno-test.test for local development.
The final step is to restart Apache:
Test our apache configuration/strong>
Start, Stop, Restart and test Apache server config
I know it is a little bit daunting but I promise that we’ll never come back to this nasty lengthy configuration file again. Four simple commands are everything that we need to remember from now on. Start, stop, restart and configuration test.
Mapping our vhosts on macOS hosts file
Add your virtual host to the bottom of the file. It should match the value you used for the ServerName configuration.
Flush macOS DNS cache:
You may receive 403 Forbidden when you visit your local site. This is likely a permissions issue. Simply put, the Apache user (_www) group (_www) needs to have access to read, and sometimes write, to your web directory.
By using the macOS preinstalled Apache and PHP we can avoid installing extra software on our macOS which sometimes could lead us to conflicts/errors/miss configuration on our Mac Operating system.
Table of Contents
- 2.1 General Installation Guidance
- 2.1.1 Supported Platforms
- 2.1.2 Which MySQL Version and Distribution to Install
- 2.1.3 How to Get MySQL
- 2.1.4 Verifying Package Integrity Using MD5 Checksums or GnuPG
- 2.1.5 Installation Layouts
- 2.1.6 Compiler-Specific Build Characteristics
- 2.2 Installing MySQL on Unix/Linux Using Generic Binaries
- 2.3 Installing MySQL on Microsoft Windows
- 2.3.1 MySQL Installation Layout on Microsoft Windows
- 2.3.2 Choosing an Installation Package
- 2.3.3 MySQL Installer for Windows
- 2.3.4 Installing MySQL on Microsoft Windows Using a
- 2.3.5 Troubleshooting a Microsoft Windows MySQL Server Installation
- 2.3.6 Windows Postinstallation Procedures
- 2.3.7 Windows Platform Restrictions
- 2.4 Installing MySQL on macOS
- 2.4.1 General Notes on Installing MySQL on macOS
- 2.4.2 Installing MySQL on macOS Using Native Packages
- 2.4.3 Installing a MySQL Launch Daemon
- 2.4.4 Installing and Using the MySQL Preference Pane
- 2.5 Installing MySQL on Linux
- 2.5.1 Installing MySQL on Linux Using the MySQL Yum Repository
- 2.5.2 Replacing a Third-Party Distribution of MySQL Using the MySQL YumRepository
- 2.5.3 Installing MySQL on Linux Using the MySQL APT Repository
- 2.5.4 Installing MySQL on Linux Using the MySQL SLES Repository
- 2.5.5 Installing MySQL on Linux Using RPM Packages from Oracle
- 2.5.6 Installing MySQL on Linux Using Debian Packages from Oracle
- 2.5.7 Deploying MySQL on Linux with Docker
- 2.5.8 Installing MySQL on Linux from the Native Software Repositories
- 2.5.9 Installing MySQL on Linux with Juju
- 2.5.10 Managing MySQL Server with systemd
- 2.6 Installing MySQL Using Unbreakable Linux Network (ULN)
- 2.7 Installing MySQL on Solaris
- 2.7.1 Installing MySQL on Solaris Using a Solaris PKG
- 2.8 Installing MySQL on FreeBSD
- 2.9 Installing MySQL from Source
- 2.9.1 Source Installation Methods
- 2.9.2 Source Installation Prerequisites
- 2.9.3 MySQL Layout for Source Installation
- 2.9.4 Installing MySQL Using a Standard Source Distribution
- 2.9.5 Installing MySQL Using a Development Source Tree
- 2.9.6 Configuring SSL Library Support
- 2.9.7 MySQL Source-Configuration Options
- 2.9.8 Dealing with Problems Compiling MySQL
- 2.9.9 MySQL Configuration and Third-Party Tools
- 2.10 Postinstallation Setup and Testing
- 2.10.1 Initializing the Data Directory
- 2.10.2 Starting the Server
- 2.10.3 Testing the Server
- 2.10.4 Securing the Initial MySQL Account
- 2.10.5 Starting and Stopping MySQL Automatically
- 2.11 Upgrading MySQL
- 2.11.1 Before You Begin
- 2.11.2 Upgrade Paths
- 2.11.3 Changes in MySQL 5.7
- 2.11.4 Upgrading MySQL Binary or Package-based Installations on Unix/Linux
- 2.11.5 Upgrading MySQL with the MySQL Yum Repository
- 2.11.6 Upgrading MySQL with the MySQL APT Repository
- 2.11.7 Upgrading MySQL with the MySQL SLES Repository
- 2.11.8 Upgrading MySQL on Windows
- 2.11.9 Upgrading a Docker Installation of MySQL
- 2.11.10 Upgrading MySQL with Directly-Downloaded RPM Packages
- 2.11.11 Upgrade Troubleshooting
- 2.11.12 Rebuilding or Repairing Tables or Indexes
- 2.11.13 Copying MySQL Databases to Another Machine
- 2.12 Downgrading MySQL
- 2.12.1 Before You Begin
- 2.12.2 Downgrade Paths
- 2.12.3 Downgrade Notes
- 2.12.4 Downgrading Binary and Package-based Installations on Unix/Linux
- 2.12.5 Downgrade Troubleshooting
- 2.13 Perl Installation Notes
- 2.13.1 Installing Perl on Unix
- 2.13.2 Installing ActiveState Perl on Windows
- 2.13.3 Problems Using the Perl DBI/DBD Interface
This chapter describes how to obtain and install MySQL. A summary of the procedure follows and later sections provide the details. If you plan to upgrade an existing version of MySQL to a newer version rather than install MySQL for the first time, see Section 2.11, “Upgrading MySQL”, for information about upgrade procedures and about issues that you should consider before upgrading.
Mysql Mac Os X
If you are interested in migrating to MySQL from another database system, see Section A.8, “MySQL 5.7 FAQ: Migration”, which contains answers to some common questions concerning migration issues.
Installation of MySQL generally follows the steps outlined here:
Determine whether MySQL runs and is supported on your platform.
Please note that not all platforms are equally suitable for running MySQL, and that not all platforms on which MySQL is known to run are officially supported by Oracle Corporation. For information about those platforms that are officially supported, see https://www.mysql.com/support/supportedplatforms/database.html on the MySQL website.
Choose which distribution to install.
Several versions of MySQL are available, and most are available in several distribution formats. You can choose from pre-packaged distributions containing binary (precompiled) programs or source code. When in doubt, use a binary distribution. Oracle also provides access to the MySQL source code for those who want to see recent developments and test new code. To determine which version and type of distribution you should use, see Section 2.1.2, “Which MySQL Version and Distribution to Install”.
Download the distribution that you want to install.
For instructions, see Section 2.1.3, “How to Get MySQL”. To verify the integrity of the distribution, use the instructions in Section 2.1.4, “Verifying Package Integrity Using MD5 Checksums or GnuPG”.
Install the distribution.
To install MySQL from a binary distribution, use the instructions in Section 2.2, “Installing MySQL on Unix/Linux Using Generic Binaries”. Alternatively, use the Secure Deployment Guide, which provides procedures for deploying a generic binary distribution of MySQL Enterprise Edition Server with features for managing the security of your MySQL installation.
To install MySQL from a source distribution or from the current development source tree, use the instructions in Section 2.9, “Installing MySQL from Source”.
Perform any necessary postinstallation setup.
After installing MySQL, see Section 2.10, “Postinstallation Setup and Testing” for information about making sure the MySQL server is working properly. Also refer to the information provided in Section 2.10.4, “Securing the Initial MySQL Account”. This section describes how to secure the initial MySQL
rootuser account, which has no password until you assign one. The section applies whether you install MySQL using a binary or source distribution.
If you want to run the MySQL benchmark scripts, Perl support for MySQL must be available. See Section 2.13, “Perl Installation Notes”.
Instructions for installing MySQL on different platforms and environments is available on a platform by platform basis:
Unix, Linux, FreeBSD
For instructions on installing MySQL on most Linux and Unix platforms using a generic binary (for example, a
.tar.gzpackage), see Section 2.2, “Installing MySQL on Unix/Linux Using Generic Binaries”.
For information on building MySQL entirely from the source code distributions or the source code repositories, see Section 2.9, “Installing MySQL from Source”
For specific platform help on installation, configuration, and building from source see the corresponding platform section:
Linux, including notes on distribution specific methods, see Section 2.5, “Installing MySQL on Linux”.
Solaris, including PKG and IPS formats, see Section 2.7, “Installing MySQL on Solaris”.
IBM AIX, see Section 2.7, “Installing MySQL on Solaris”.
FreeBSD, see Section 2.8, “Installing MySQL on FreeBSD”.
For instructions on installing MySQL on Microsoft Windows, using either the MySQL Installer or Zipped binary, see Section 2.3, “Installing MySQL on Microsoft Windows”.
For details and instructions on building MySQL from source code using Microsoft Visual Studio, see Section 2.9, “Installing MySQL from Source”.
For installation on macOS, including using both the binary package and native PKG formats, see Section 2.4, “Installing MySQL on macOS”.
For information on making use of an macOS Launch Daemon to automatically start and stop MySQL, see Section 2.4.3, “Installing a MySQL Launch Daemon”.
For information on the MySQL Preference Pane, see Section 2.4.4, “Installing and Using the MySQL Preference Pane”.