Skip to content

Instantly share code, notes, and snippets.

@robhrt7
Forked from nrollr/MySQL_macOS_Sierra.md
Last active November 4, 2024 19:55
Show Gist options
  • Save robhrt7/392614486ce4421063b9dece4dfe6c21 to your computer and use it in GitHub Desktop.
Save robhrt7/392614486ce4421063b9dece4dfe6c21 to your computer and use it in GitHub Desktop.
Install MySQL 5.7 on macOS using Homebrew

This is a fork of original gist https://gist.github.com/nrollr/3f57fc15ded7dddddcc4e82fe137b58e, with slight changes on pointing to 5.7 version branch, instead of 8 (latest default of MySQL in Hombrew).

Install MySQL 5.7 on macOS

This procedure explains how to install MySQL using Homebrew on macOS (Sierra 10.12 and up)

Install Homebrew

  • Installing Homebrew is effortless, open Terminal and enter :
    $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
  • Note: Homebrew will download and install Command Line Tools for Xcode 8.0 as part of the installation process.

Install MySQL

At this time of writing, Homebrew has MySQL version 8 as default, but as we're aiming to get 5.7, we'll need to append @5.7 to the default package key:

To install MySQL enter : $ brew install [email protected]

Additional configuration

Homebrew

  • Install brew services first : $ brew tap homebrew/services

  • Load and start the MySQL service : $ brew services start [email protected].
    Expected output : Successfully started mysql (label: homebrew.mxcl.mysql)

  • Check of the MySQL service has been loaded : $ brew services list 1

  • Force link 5.7 version - $ brew link [email protected] --force

  • Verify the installed MySQL instance : $ mysql -V.
    Expected output : Ver 14.14 Distrib 5.7.22, for osx10.13 (x86_64)

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 macOS.
Current version available: 1.1.2

Comments

1 The brew services start [email protected] - instruction is equal to :

$ ln -sfv /usr/local/opt/mysql/*.plist ~/Library/LaunchAgents
$ launchctl load ~/Library/LaunchAgents/homebrew.mxcl.mysql.plist
@isaac-tribal
Copy link

Works great until I attempt to create a password for root:

$ mysqladmin -u root password 'yourpassword'

I get the following error:

... Failed! Error: Column count of mysql.user is wrong. Expected 45, found 43. Created with MySQL 50615, now running 50732. Please use mysql_upgrade to fix this error.

Any advice would be much appreciated?

run this command, it will prompt a form about setting up root password

mysql_secure_installation

@mefuru
Copy link

mefuru commented Mar 1, 2021

Works great until I attempt to create a password for root:
$ mysqladmin -u root password 'yourpassword'
I get the following error:
... Failed! Error: Column count of mysql.user is wrong. Expected 45, found 43. Created with MySQL 50615, now running 50732. Please use mysql_upgrade to fix this error.
Any advice would be much appreciated?

run this command, it will prompt a form about setting up root password

mysql_secure_installation

Did the trick, thanks!

@KeithTt
Copy link

KeithTt commented Mar 8, 2021

Thanks a lot!!!

@rolasteph
Copy link

I followed the instructions and did a clean install.
I got to the same "mysqladmin" point, but failed differently...

% mysqladmin -u root password '---redacted---'
mysqladmin: connect to server at 'localhost' failed
error: 'Access denied for user 'root'@'localhost' (using password: YES)'

To get past this, here's what I ended up having to do:

  • Enter mysql and add a password for “root” user:

    • mysql -u root -p
    • It will prompt for password. THERE IS NO PASSWORD YET, SO JUST HIT ENTER
    • you should get the mysql> prompt
  • At the mysql> prompt:

    • mysql> use mysql;
    • mysql> update user set authentication_string=password("<desired root password>") where user="root";
    • mysql> exit
  • Restart the service to pick up the change:

Now, when you do mysql -u root -p it will prompt for password and accept the new password you set above.

@sameeraswal
Copy link

I had to do below steps after following the given instructions:-
sudo mkdir /usr/local/var/mysql
sudo chmod 777 /usr/local/var/mysql
brew services restart [email protected]

@seemly
Copy link

seemly commented May 24, 2021

When setting up my Apple M1 Macbook Pro I was experiencing the issue of the following error message being thrown:

Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

My fix was to modify the MySQL config file:

nano /usr/local/etc/my.cnf

Append the following lines:

tmpdir=/tmp
user=root

Then run:

brew services restart [email protected]

This fixed my issue, and I was then able to connect successfully with my DB client.

@nima-z
Copy link

nima-z commented Nov 5, 2022

Thank you, It worked on macOS Monterey.

@claide
Copy link

claide commented Mar 23, 2023

Not working for me on mac os m2 ventura.

I did start [email protected] and gives me Successfully started [email protected] (label: [email protected]) message. But, when I tried to view the list of services to check if it's really started, I got this status below which is stopped.

image

@minily
Copy link

minily commented Feb 28, 2024

much good!

@milo-lamar
Copy link

Any suggestions since 2024-08-01?
% brew install [email protected] Error: [email protected] has been disabled because it is not supported upstream! It will be disabled on 2024-08-01.

@ibadk5304
Copy link

@milo-lamar Have you managed to resolve this

@milo-lamar
Copy link

milo-lamar commented Aug 16, 2024 via email

@newtrat
Copy link

newtrat commented Aug 19, 2024

@ibadk5304 I was able to get part of the way to installing 5.7 again, but ended up reaching an error I couldn't resolve. Like Milo, I was able to switch to 8.0, but if you can't, I hope this might get you partway there:

  • Install Homebrew's packages locally: brew tap homebrew/core --force
  • open /opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/m/[email protected] and comment out the line disabling the formula (line 22). In my experience, Homebrew kept overwriting this change, so you might have better luck copying the file to some new name instead.
  • HOMEBREW_NO_INSTALL_FROM_API=1 brew install --build-from-source /opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/m/[email protected] Or use the new file copy if you created one in the last step.

This approach allowed MySQL to start installing, but I still ran into an error:

Error: An exception occurred within a child process:
  Errno::ENOENT: No such file or directory @ apply2files - /opt/homebrew/Cellar/[email protected]/5.7.44_1/data

... and I couldn't figure out how to solve that issue. The non-existent file here seems like it's something Homebrew is supposed to add during the installation process. When I created the file myself, Homebrew thought [email protected] was "already installed."

@douglas
Copy link

douglas commented Aug 21, 2024

What I did here was to use instead [email protected], which is greatly compatible with MySQL 5.7 - so instead of using [email protected] you can just use [email protected] to replace it 🎉

@Pezmc
Copy link

Pezmc commented Aug 26, 2024

brew tap homebrew/core --force
brew edit [email protected]
# Remove disable! line
HOMEBREW_NO_INSTALL_FROM_API=1 brew install [email protected]

@brobertsaz
Copy link

@Pezmc you solution worked great. I tried upgrading to mysql 8 and had issues but I had already uninstalled 5.7 :(

@EricFromCanada
Copy link

Error: An exception occurred within a child process:
  Errno::ENOENT: No such file or directory @ apply2files - /opt/homebrew/Cellar/[email protected]/5.7.44_1/data

@newtrat To fix this, follow instructions from @Pezmc and also add this just before the system "cmake" line:

mkdir prefix/"data"

@zbt78
Copy link

zbt78 commented Oct 12, 2024

HOMEBREW_NO_INSTALL_FROM_API=1 brew install [email protected]

this works for me!

@andrew-bierman
Copy link

Thanks, everyone, for this thread! The steps from @Pezmc worked great for me. The only change I had to make was updating depends_on "[email protected]" to depends_on "openssl@3" when modifying the mysql formula in my set up.

I didn’t experience any breaking changes with this patch, but your mileage may vary.

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