This tutorial helps you set up a basic localhost DEV environment on MacOS using Homebrew, to run WordPress (or any other PHP powered web-app) locally.
Installing Local, MAMP or other local server environments for testing and development may be an overhead if you just need a plain-vanilla web server that can be kept up-to-date easily.
⚠️ Before proceeding, please make sure that you’re using the latest MacOS version. Windows users should install a preconfigured DEV environment like XAMPP, MAMP for Windows or WampServer – if you feel comfortable you can try to setup Homebrew via Windows Subsystem for Linux (WSL). Linux users need to follow the official Homebrew on Linux guide and will have to change some file paths accordingly.
MacOS
Prerequisites
- Visual Studio Code
Visual Studio Code has become the de-facto standard in web development but any pre-installed editor will be sufficient. - Terminal
MacOS app to perform shell commands. Any code snippet below starting with$needs to be executed via a Terminal Emulator. - XCode Command line tools
Required by Homebrew. - Homebrew
Package manager for MacOS/Linux that helps you install the latest software packages for your localhost environment and automatically launches required processes when you start your system. Outdated packages can be updated with a single command. - WordPress
Content Management System powered by PHP.
XCode Command Line Tools
$ xcode-select --install
(Alternatively you can download and install XCode directly: https://apps.apple.com/us/app/xcode/id497799835)
Install Homebrew
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
(Alternatively you can download and install the following .pkg file: https://github.com/Homebrew/brew/releases)
$ brew doctor
😀 Your system is ready to brew.
Install Apache web server
The Apache HTTP Server “httpd” is the most popular web server on the Internet.
httpd.apache.org
First, make sure that any running internal Apache server has been stopped and unloaded from the launch processes:
$ sudo apachectl -k stop
$ sudo launchctl unload -w /System/Library/LaunchDaemons/org.apache.httpd.plist 2>/dev/null
Now you can install and launch the new server:
$ brew install httpd
$ brew services start httpd
Install PHP
PHP is a popular general-purpose scripting language that is especially suited to web development.
php.net
Fast, flexible and pragmatic, PHP powers everything from your blog to the most popular websites in the world.
$ brew install php
$ brew services start php
Install MariaDB
MariaDB has been forked from MySQL and is highly backwards compatible.
MariaDB Community Server sets the standard for open source relational databases, with Oracle Database compatibility (e.g., sequences and PL/SQL), temporal tables, transparent sharding, instant schema changes, point-in-time rollback and modern SQL (i.e., common table expressions, window functions, JSON functions and more).
mariadb.com
$ brew install mariadb
$ brew services start mariadb
Test the status of each service
$ brew services
| Name | Status | User | File |
|---|---|---|---|
| httpd | started | {YOUR_USERNAME} | ~/Library/LaunchAgents/homebrew.mxcl.httpd.plist |
| mariadb | started | {YOUR_USERNAME} | ~/Library/LaunchAgents/homebrew.mxcl.mariadb.plist |
| php | started | {YOUR_USERNAME} | ~/Library/LaunchAgents/homebrew.mxcl.php.plist |
If something is wrong you can try to restart the service(s).
$ brew services restart httpd
$ brew services restart mariadb
$ brew services restart php
Setup your server directory
Create a new folder in your user directory and execute the following commands. You will also create two debug info pages that may be helpful:
$ mkdir ~/Localhost$ echo "<h1>It works!</h1>" > ~/Localhost/index.html$ echo "<?php phpinfo();" > ~/Localhost/phpinfo.php
⚠️ “Localhost” is just a suggestion and you can choose whatever folder name you prefer.
Configure the database
Change the root password and create a new empty database for WordPress.
$ sudo mysql
$ ALTER USER 'root'@'localhost' IDENTIFIED BY '{NEW_PASSWORD}';
⚠️ The password is required to access the database and you’ll need it later – store the access credentials (Username “root” + chosen password) in your password manager or write it down somewhere.
$ CREATE DATABASE wordpress;
⚠️ You are free to choose a different database name.
Configure the web server
‼️ Find the default Apache configuration file in /opt/homebrew/etc/httpd/httpd.conf (on Mac computers with Apple silicon) or in /usr/local/etc/httpd/httpd.conf (on Mac computers with Intel processors), create a backup (e.g. httpd_backup.conf) and open httpd.conf in a text editor.
Uncomment or adapt the following lines and save the changes afterwards:
| Before | After |
|---|---|
ServerRoot "/opt/homebrew/opt/httpd" | ServerRoot "/opt/homebrew/opt/httpd"⚠️ The /homebrew path may differ depending on your system (‼️) |
Listen 8080 | Listen 80 |
# LoadModule vhost_alias_module lib/httpd/modules/mod_vhost_alias.so | LoadModule vhost_alias_module lib/httpd/modules/mod_vhost_alias.so |
# LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so | LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so⚠️ The /homebrew path may differ depending on your system (‼️) |
User _www | User {YOUR_USERNAME}⚠️ Insert your MacOS username |
DocumentRoot "/opt/homebrew/var/www"AllowOverride None | DocumentRoot "/{YOUR_USERNAME}/Localhost"AllowOverride None⚠️ Insert your MacOS username and use the directory you defined earlier |
<IfModule dir_module> DirectoryIndex index.html | <IfModule dir_module> DirectoryIndex index.php index.html |
# PHP settings⚠️ The /homebrew path may differ depending on your system (‼️) ⚠️ Append this text at the bottom of the file |
It works!
Open http://localhost – if you see the notice “It works!“, the local server is up and running 👏
Now open http://localhost/phpinfo.php and check the PHP server info. The page should look like this, stating the current PHP version.
Install and setup WordPress
Finally it’s time to run the WordPress install script.
Download and extract the latest WordPress Core ZIP in an arbitrary Localhost directory (e.g. /{YOUR_USERNAME}/Localhost/wordpress), access http://localhost/wordpress/wp-admin/install.php and follow the setup guide by entering the database credentials defined earlier.
Finish the installation by setting the WP user credentials and by logging in to WordPress: http://localhost/wordpress/wp-login.php
Some recommended tools that may make your WordPress developer life easier are Multisite Network (Maintain multiple sites on a single WordPress installation), Composer (PHP package manager), WP-CLI (Command-line interface for WordPress), phpMyAdmin or Adminer (Database management tools) and PHP Code Sniffer (PHP code quality and coding standards) in combination with the WordPress Coding Standard rules.
Are you using one of our WordPress Starter Themes? Feel free to install node.js/npm via Homebrew to consolidate all development tools and build processes in one place.
Keep all Homebrew packages up-to-date
It’s strongly advised to always update to the latest software versions available.
$ brew update && brew cleanup
$ brew upgrade
Yes, you can use this local server to run other applications besides WordPress!
Feel free to install and setup any web tool that’s powered by PHP (and MySQL/MariaDB) on your new localhost environment. In addition to WordPress, covered in this post, some other popular applications you can use, include:
- Drupal (Content Management System)
- TYPO3 (Content Management System)
- Joomla (Content Management System)
- Nextcloud (Private Cloud server)
- Magento (E-Commerce)
- Matomo (Web analytics)
- MediaWiki (Wiki software)
- … just to name a few
That’s all for now
The instructions may be updated from time to time to reflect any OS specific changes. If you have questions, recommendations or just would like to say ❤️ Thank you, post a comment below.