Create a gist now

Instantly share code, notes, and snippets.

@nrollr /
Last active Nov 23, 2017

What would you like to do?
Install MySQL on El Capitan using Homebrew

Install MySQL on OS X El Capitan

Normally the installation of MySQL can be achieved with a single command, which executes a script provided by MacMiniVault : bash <(curl -Ls

However, at the time of writing the script is not compatible with OS X El Capitan (10.11)

Install MySQL using Homebrew

An alternative to the aforementioned installation script is installing MySQL using Homebrew. This gist assumes you already have Homebrew installed, if not first read the article "Homebrew and El Capitan"

Make sure Homebrew has the latest formulae, so run brew update first
-OR- make sure Homebrew has MySQL version 5.6.27 as default formulae in its main repository :

  • Enter the following command : brew info mysql
  • Expected output: mysql: stable 5.6.27 (bottled)

Next install MySQL with : brew install mysql

###Additional configuration Open Terminal and execute the following commands :

  • To have launchd start mysql at login :
    ln -sfv /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents
  • To load mysql immediately :
    launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist
  • Finally add the mysql directory to your PATH environment variable in .bash_profile :
export MYSQL_PATH=/usr/local/Cellar/mysql/5.6.27  
  • Reload shell and type mysql -v to confirm
    Expected output : Server version: 5.6.27 Homebrew
    Quit the mysql CLI via mysql> \q

###Configure MySQL Open Terminal and execute the following command to set the root password:
mysqladmin -u root password 'yourpassword'

Important : Use the single ‘quotes’ to surround the password and make sure to select a strong password !

###Database Management To manage your databases, I recommend using Sequel Pro, a MySQL management tool designed for OS X

iplus26 commented Jul 30, 2016

Thanks for your guide!

For some one might be here, if you ran into ERROR 1045 (28000): Access denied for user 'Ivan'@'localhost' (using password: NO) like me, try this: mysql -v -uroot -pYourpasswordhere.

this is a great How-To and works fine even in Mac OS X El Capitan! 👍

beritou commented Aug 15, 2016

@nrollr thank you for this Gist. Please consider updating it for v5.7.14 as per my fork

rdp commented Oct 20, 2016

latest seems to be just "brew install mysql" then homebrew itself outputs instructions on how to install the daemon/change the root password (FWIW)...

Alternatively, to start mysql one could also use brew services (brew tap homebrew/services):

brew install mysql
brew services start mysql

hassanabidpk commented Jan 22, 2017

I tried mysqladmin -u root password 'yourpassword' and mysql -v -uroot -pYourpasswordhere on MACOS Sierra but still getting the error ERROR 1045 (28000): Access denied for user 'root'@'localhost' Anyone facing similar problem ?

Thank you!!

Thanks a lot

I followed the instructions thoroughly, entered mysql -v into terminal, and got a weird error ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

amfische commented Feb 15, 2017

I received the same error as james-prado. All I ran was brew install mysql

This article helped me solve my problem:

is there a way to install only the cli client?

same problem as @hassanabidpk. no luck

@hassanabidpk and @tejasmanohar hope this helps.
Just type following in your terminal instead
Note : -u represent your mysql username which is root in my case and -p represent password

mysql -uroot -p
Enter password:

Seeing some people on here run into problems with using mysql -uroot -p. If you didn't set up a password, try entering a blank one.

Source: The last 5 minutes of my life.

innokenty commented Mar 29, 2017

Right after I installed it with homebrew I get this:

$ mysql -v
ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

UPD: mysql --version works by the way!

rubi0 commented May 7, 2017

For those having ERROR 1045 (28000): Access denied for user 'x'@'localhost' (using password: NO) just do sudo mysql -v ...

for me everything works fine locally. but when I try to connect remotely. I get error

ERROR 2003 (HY000): Can't connect to MySQL server on '' (61)

I can connect using the same user locally. I have already disabled firewall.

jotacedesigner commented Jun 23, 2017

if you have this problem ERROR 1045 (28000): Access denied for user 'x'@'localhost' (using password: NO),
###Configure MySQL Open Terminal and execute the following command to set the root password:
mysqladmin -u root password 'yourpassword'.
And crate a alias for mi work this:
The alias create in your bash_profile in your terminal:
nano ~/.bash_profile
When open paste this:
alias mysql='/usr/local/Cellar/mysql/5.7.18_1/bin/mysql -u root -p'

yeah not working for me either...

JamesJefferyUK commented Aug 1, 2017

People are likely having issues because the OP has set the path wrong. Rather than doing:

export MYSQL_PATH=/usr/local/Cellar/mysql/5.6.27  

It should be:

export MYSQL_PATH=/usr/local/Cellar/mysql/5.6.27  

... See how the $PATH is added to the end. If you don't do this when you call mysql it's going to load the version installed with OSX. You can test this by doing which mysql ... it should show /usr/local/Cellar/mysql/5.7.19/bin/mysql when you set the path correctly.

svaponi commented Sep 17, 2017

If you have this error:

ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

Type mysql -uroot -p and as password type exactly yourpassword (not your actual sudo password). It works ;)

Great document! I'm a fan of as a database GUI.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment