Apache

Before starting: Make sure you have the necessary folders and permissions — get more information.

Links: Homepage | Downloads | Documentation
Dependencies: APR | APR-util | PCRE
Version: 2.4.23

The Apache HTTP Server is an open-source web server that was released in 1995.

Get the Code

Switch to /usr/local/src and download the source package.

cd /usr/local/src
curl --remote-name http://apache.mirror.iweb.ca//httpd/httpd-VERSION.tar.gz

Extract the archive and move into the folder.

tar -xzvf httpd-VERSION.tar.gz
cd httpd-VERSION

Compile and Install

Configure, compile and install into /usr/local/mac-dev-env/apache-VERSION.

./configure --prefix=/usr/local/mac-dev-env/apache-VERSION --enable-so
make
make install

Create a symbolic link to /usr/local/apache.

ln -s mac-dev-env/apache-VERSION /usr/local/apache

Configuration File

Edit Apache's configuration file.

nano /usr/local/apache/conf/httpd.conf

Copy and paste the following text at the end of the aforementioned file. Make sure you replace the <username> string (3 times) with your macOS short username. This configuration only allows access from your local computer; all outside access is blocked.

ServerName dev.local
User <username>
Group staff

DocumentRoot "/Users/<username>/Sites"
ErrorLog "/usr/local/var/log/apache.log"
CustomLog "/usr/local/var/log/apache.log" common
<Directory "/Users/<username>/Sites">
  Options All
  AllowOverride All
  IndexOptions NameWidth=*

  Require all denied
  Require host localhost
  Require host 127.0.0.1
</Directory>

You also need to disable the ErrorLog and CustomLog directives in the Apache configuration file (leaving the above directives intact). Otherwise, Apache will log the same information in two separate locations.

Web Root

Create a folder that will contain your web sites and applications. I keep my projects in ~/Sites. You can place your projects wherever you'd like but make sure you update the path when mentioned in this article.

mkdir -p ~/Sites

Shell

Execute the following lines to update your Bash startup script.

echo 'export PATH=/usr/local/apache/bin:$PATH' >> ~/.bash_profile
echo 'export MANPATH=/usr/local/apache/man:$MANPATH' >> ~/.bash_profile

Load the new shell configurations.

source ~/.bash_profile

Manual Start/Stop

To start the HTTPd.

sudo apachectl start

To shut down the HTTPd.

sudo apachectl stop

Automatically Start the Server at Boot

Create a configuration file for Launchd.

sudo nano /Library/LaunchDaemons/org.apache.apache2.plist

Do not name the file org.apache.httpd.plist as it collides with a similarly named file for loading the macOS web server.

Copy and paste the following text into the aforementioned file.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>Label</key>
    <string>org.apache.apache2</string>

    <key>ProgramArguments</key>
    <array>
      <string>/usr/local/apache/bin/httpd</string>
      <string>-D</string>
      <string>FOREGROUND</string>
    </array>

    <key>StandardOutPath</key>
    <string>/usr/local/var/log/apache.log</string>
    <key>StandardErrorPath</key>
    <string>/usr/local/var/log/apache.log</string>

    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
  </dict>
</plist>

Register with Launchd and start the server.

sudo launchctl load /Library/LaunchDaemons/org.apache.apache2.plist

Deregister with Launchd.

sudo launchctl unload /Library/LaunchDaemons/org.apache.apache2.plist

Verify the Installation

Verify that you have successfully installed Apache.

httpd -v

Visit your web server root page.

http://localhost/