Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
brewStack Docs

brewStack update for fresh install

Install steps:

  • Install Homebrew:

    • Follow the install instructions found on this page.
  • Tap the wonderful homebrew-php from

      $ brew tap homebrew-php
  • Install php with apache and mariadb

      $ brew install mariadb  
      $ brew install php55   
  • Add the following to /etc/apache2/httpd.conf

      LoadModule php5_module /usr/local/opt/php55/libexec/apache2/
  • Apache 2.4 in OS X Yosemite does not enable mod_rewrite by default. Feel free to enable it if needed.

  • Set the Apache user and group directives to your user shortname and the staff group. Do this in the file /etc/apache2/httpd.conf

    • Restart Apache
    • This allows Apache to host sites in folders other than ~/Sites


  • Make sure Apache and MariaDB are not accessible outside of your Mac

  • MariaDB

    • Pick a cnf file from /usr/local/Cellar/mariadb//<current-version#>/support-files and copy it to /usr/local/etc/my.cnf.d/

    • I used my-medium.cnf

    • Edit the my.cnf file in the [mysqld] settings area:

    • Comment out:

      #binary logging is required for replication   
      #binary logging format - mixed recommended   
  • For enhanced security, you can remove the above and add the following to my.cnf in the [mysqld] settings area. This prevents any TCP/IP connections to MariaDB. This changes will require your applications support database socket connections.

  • Issue the following command and follow the setup instructions to your liking. You will should get prompted by the system firewall to allow or deny mysqld connections when you first start MariaDB. Deny access!

      $ brew info mariadb
  • Once you have it setup, issue this commend to start the server manually:

      $ mysql.server start
  • Apache

    • Make sure that new vhosts only listen to Same goes for any port.
    • Block all incoming connections to /usr/sbin/httpd using the OS X Firewall settings in System Preferences

Additional setup

  • Helpful bit for your .zshrc to include homebew-php binaries to the system path

      PATH="$(brew --prefix  homebrew/php/php55)/bin:$PATH"
  • For large databases, you may need to incrase the max_allowed_packet size in my.cnf to something like the example below:




This comment has been minimized.

Copy link

@tlattimore tlattimore commented Oct 17, 2014

It looks like on Yosemite mod_rewrite isn't enabled by default (I seem to remember it being before but could be wrong). This is a requirement for a number of PHP applications. It can be enabled by uncommenting line 168 of /etc/apache2/httpd.conf.


This comment has been minimized.

Copy link
Owner Author

@shrop shrop commented Oct 26, 2014

@tlattimore: I had the same issue. I will make sure to note that in the docs. Thanks!


This comment has been minimized.

Copy link

@deetergp deetergp commented Oct 27, 2014

Looks good @shrop! I'd recommend changing the tap named homebrew/homebrew-php to just homebrew/php.


This comment has been minimized.

Copy link
Owner Author

@shrop shrop commented Oct 30, 2014

Thanks @deetergp, made the change.


This comment has been minimized.

Copy link

@deetergp deetergp commented Jan 13, 2015

May want to change the group in httpd.conf to "staff" rather than admin. I ran into issues with Apache not restarting properly when I had it set to "admin".

Also might want to consider bumping max_allowed_packet up to 1026M in my.cnf.


This comment has been minimized.

Copy link
Owner Author

@shrop shrop commented Mar 6, 2015

Thanks for all the suggestions. I think they are all implemented. I did some overall readability improvements also.

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