Alex McFarlane

Useful Stuff

Set Up MySQL in OSX with Homebrew

Quick start guide going over how I set up MySQL on macOS Sierra



Install with homebrew

Update brew and fix any pressing issues with doctor

brew update
brew doctor

then install with

brew install mysql

and you should receive an output similar to

We've installed your MySQL database without a root password. To secure it run:

To connect run:
    mysql -uroot

To have launchd start mysql now and restart at login:
  brew services start mysql
Or, if you don't want/need a background service you can just run:
  mysql.server start
==> Summary
🍺  /usr/local/Cellar/mysql/5.7.16: 13,511 files, 439M

Secure Installation

  1. Start mysql by running

     brew services start mysql
  2. Run the installation script

  3. You will be asked to set up a setup VALIDATE PASSWORD plugin. Enter y to do this.
  4. Select the required password validation (Doesn’t really matter if it is just you using the database)
  5. Now select y for all the remaining options: Remove anon. users; disallow remote root logins; remove test database; reload privileges tables.
  6. Now you should receive a message of

     `All done!`

If you receive the error of

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

then it is likely you don’t have mysql running. Make sure to do the first step here

Log in

Log in to MySQL as root with

mysql -u root -p

See the docs for creating users, databases etc. The version can be obtained by

mysql --version

where confusingly Distrib refers to the documentation number

Managing the Background Service

The command

brew services start mysql

will start mysql and this service will be started at login in perpetuity. To stop the service in perpetuity run the command

brew services stop mysql

further examples can be found by reading the simple docs

Python Interface

Install pymysql with

pip install pymysql

and read here for the advantages over MySQLdb. A simple example interfacing using the root that was set up earlier can be seen by the following example. Log in via

mysql -u root -p

and enter the following SQL code to create a test DATABASE and TABLE with

CREATE DATABASE example_database;
USE example_database;
CREATE TABLE `users` (
    `id` int(11) NOT NULL AUTO_INCREMENT,
    `email` varchar(255) COLLATE utf8_bin NOT NULL,
    `password` varchar(255) COLLATE utf8_bin NOT NULL,
    PRIMARY KEY (`id`)

now the following script saved as

import pymysql
import argparse
import getpass

class Password(argparse.Action):
    def __call__(self, parser, namespace, values, option_string):
        if values is None:
            values = getpass.getpass()
        setattr(namespace, self.dest, values)

parser = argparse.ArgumentParser()
parser.add_argument('-u', dest='user', required=True)
parser.add_argument('-p', action=Password, nargs='?',
	 dest='password', required=True)
args = parser.parse_args()

connection = pymysql.connect(host='localhost',

    with connection.cursor() as cursor:
        # Create a new record
        sql = "INSERT INTO `users` (`email`, `password`) VALUES (%s, %s)"
        cursor.execute(sql, ('', 'very-secret'))

    # connection is not autocommit by default. So you must commit to save
    # your changes.

    with connection.cursor() as cursor:
        # Read a single record
        sql = "SELECT `id`, `password` FROM `users` WHERE `email`=%s"
        cursor.execute(sql, ('',))
        result = cursor.fetchone()

and run as

python -u root -p

to give the output of

{u'password': u'very-secret', u'id': 1}

to remove the example_database, log in to mysql and invoke

DROP DATABASE example_database;