DEV Community

crankysparrow
crankysparrow

Posted on • Updated on

Configuring Virtual Hosts With MAMP

When I'm developing for WordPress, I use MAMP to serve my sites locally. By default, MAMP serves to port 8888. I keep all my WordPress work in one folder served up by MAMP, so each site in that folder is served at localhost:8888/mysite.

At some point I started running into problems with this URL structure, mainly because root-relative URLs would link to the wrong places. For example, on a site at localhost:8888/mysite, <img src="/image.jpg"/> would link to localhost:8888/image.jpg instead of localhost:8888/mysite/image.jpg like I needed it to.

I needed a way to serve my sites locally with a base URL these relative links to resolve to. Enter virtual hosts! These allow us to serve content to multiple domain names at once.


Here's how I set up MAMP with virtual hosts on my Mac:

1. Edit hosts file

The /etc/hosts file on your local machine maps custom domain names to the IP addresses. It's protected, so you'll likely have to use sudo to open it and enter your Mac password.

To edit your hosts file in vim, open your preferred terminal and enter sudo vim /etc/hosts. You'll see something like:

##
# Host Database
#
# localhost is used to configure the loopback interface
# when the system is booting.  Do not change this entry.
##
127.0.0.1       localhost 
Enter fullscreen mode Exit fullscreen mode

Don't delete anything, just add another line beneath the localhost line with your desired host name like this:

127.0.0.1       localhost
127.0.0.1       yoursite.loc
Enter fullscreen mode Exit fullscreen mode

Then save the file and exit.

I like to end mine with .loc but you can use .dev or something else as well. It should be unique but easy for you to remember.

2. Edit MAMP Apache config file

Now go to the directory your MAMP install is located in. Mine is at /Applications/MAMP which is the default, so that's what I'll use as the path for the following examples.

Find the Apache config file at /Applications/MAMP/conf/apache/httpd.conf and open it in an editor. There's likely a bunch of stuff in here; scroll through and find these lines:

# Virtual hosts
# Include /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf
Enter fullscreen mode Exit fullscreen mode

All you need to do here is un-comment that second line, so it looks like this:

# Virtual hosts
Include /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf
Enter fullscreen mode Exit fullscreen mode

Save the file.

3. Edit your virtual hosts file

Next, open the virtual hosts file at /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf.

There will probably be some comments and a couple of examples of blocks there. Leave the comments or delete as you'd like, then replace the examples with the information below. The second block includes the path to the site you're developing and the local domain name you added in the first step. So your file should look something like this:

NameVirtualHost *:80

<VirtualHost *:80>
    DocumentRoot "/Applications/MAMP/htdocs"
    ServerName localhost
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "/Users/youruser/your/site/root"
    ServerName yoursite.loc
</VirtualHost> 
Enter fullscreen mode Exit fullscreen mode

4. You're Done!

Restart MAMP if it was running already and head to the domain you added. Your site should be live there!


Just in case...

If you run into errors, you may also need to go back to the httpd.conf file we edited above and allow SymLink override. Open that file, find the block below, and make sure AllowOverride is set to All rather than None. So it should look like this:

<Directory />
    Options Indexes FollowSymLinks
    AllowOverride All
</Directory>
Enter fullscreen mode Exit fullscreen mode

I hope this is helpful for anyone needing a reference for setting this up! Feel free to comment and let me know if you have any questions or suggestions.

Top comments (5)

Collapse
 
sandeshsapkota profile image
sandeshsapkota • Edited

Hi Its not working for me.

Include /Applications/MAMP/conf/apache/extra/httpd-vhosts.conf

`
DocumentRoot "/Applications/MAMP/htdocs"
ServerName localhost


DocumentRoot "/Applications/MAMP/htdocs/aca-wp-website"
ServerName aca-wp-website.loc
`

on host file


127.0.0.1 localhost
127.0.0.1 aca-wp-website.loc

Collapse
 
paredestoquero profile image
Chris

Hi thanks for the info, but I have a problem, if I put demo.com it doesn't work, but if I put demo.localhost it works... do you know why? For demo.com it says the 404 error... :(
Thanks!

Collapse
 
cosmicmarkup profile image
Brennan

Thank you! This helped me

Collapse
 
jdurham85 profile image
Jermaine Durham

Thanks, this help out a lot.

Collapse
 
borntokickpk profile image
Muhammad Hassan Javed

Thanks.