I just launched a new course on ES6! Use the code WESBOS for $10 off.

Strengthen your core JavaScript skills and master all that ES6 has to offer. Start Now →

How to test localhost from any device on your network

If you do any sort of web development locally you have probably run into at least one of the following problems:

  1. I can’t access my local sites/apps on my mobile devices
  2. I can’t access localhost inside of my virtual machines
  3. My teammates can’t access my local site to view it
  4. I need to test IE6 on my Toshiba crapbook

Pushing your site to a server isn’t ideal, especially when you are debugging a problem and have a longer deploy process.

I develop everything locally and have to test my sites/apps on a variety of mobile devices as well as a few different installs of windows which I run on Virtual Box. This is how I run a single development domain that is available to every device on my wireless network as well as on my laptop, regardless of the wifi network I’m on.

My Setup

photo (2)

Before we get started, I should say that is works for any programming language that runs a local server. My setup looks something like this:

http://test.com is my domain that I map everything to. I can access test.com on any device on my network. It obviously not the real test.com, but as you will see it resolves to localhost. This domain could be anything – some devs like to run something like http://wes.dev/ but I find using a .com works better as sometimes browsers think I’m searching for wes.dev instead of going to wes.dev.

I run MAMP to serve up both my static files and my static files. I usually have mamp serving up my entire web devleopment folder so I can easily just surf to something like http://test.com/demos/webrtc-demo/ on any device. This is most common for me, so I run this on the default web traffic port 80. If you don’t do PHP development, I reccomend using pythons simplehttpserver as MAMP or WAMP are a pain to get up and running properly.

I run node.js apps on various ports. Express apps run on port 3000 by default so I just need to surf to http://test.com:3000 on any device.

I also have clients who have ruby and python/app engine backends. I usually run these on ports that are easy to remember like 8888. I keep these ports unique for each app so my browser history know the difference between http://test.com:8888 and http://test.com:9000

Just use an IP! What about  localtunnel?! 

I posted on twitter that I was writing this article and I got quite a few people asking why I didn’t just use an IP address or localtunnel. Using an IP isn’t ideal because many times applications I run depend on having a consistent domain name. With many CMS systems such as WordPress, I can’t really develop on localhost  and then view the site on I use a few browser plugins that send my current site to my devie and having the exact same domain name is key here.

Services like localtunnel and PageKit are fantastic for quickly exposing your localhost and are invaluable when working on a remote team. However, we still run into the problem of  having different domains for your machine vs the device. So, you may still require these services and thats great, it just doesn’t replace what we are trying to do here.

Local Setup – edit your hosts file

This is the easy part. We want to edit a file on our computer called the hosts file.  This file tells your computer to resolve names to IP Addresses. So, anytime your computer requests a name – say test.com – it will check the hosts file to see if there is an IP it should resolve to.  Otherwise it carries on with its business and tries to load the web page.

Your hosts file is just a text file so you don’t need any special program.  Just open up the following file:

OSX: open terminal (applications → utilities → terminal) and type sudo open /etc/hosts. You will be asked to enter your password and then the file will open up in your text editor of choice.
Windows: Start → Run → paste notepad c:\windows\system32\drivers\etc\hosts into the box.

Now we just need to map a domain to localhost. We use the IP address because that is the IP for your computer’s localhost.

Go ahead and pop the following line anywhere in your hosts file: test.com

Give it a save (you may be asked to enter your password)

ss 2013-01-25 at 12.45.17 PM

You can map any domain name to an alternate IP address. So, if you wanted to play a prank on a co-worker or block your wife from pinterest, you could easily tell it to resolve to any other IP. This is how those ‘self control’ apps work as well.

# Map Pinterest to google.com pinterest.com

# Disable facebook.com facebook.com

Now when you visit http://test.com you should see your localhost instead on whatever used to be on test.com. If you don’t see it, you can flush your DNS cache:

OSX Paste the following into terminal sudo killall -HUP mDNSResponder
Windows: Start → run → cmd (right click, run as admin): ipconfig /flushdns

Router Level Setup

The above has set you up for a local domain resolution of test.com – but what about when you want to visit test.com on another device? I have at least 20 different devices/vms to test and some of them, like the iPhone, don’t even allow you to edit the hosts file!

The answer is setting up a similar resolution, but at the router level. We will tell the router to resolve all requests for test.com to the IP address of your computer. When I first set out to do this, I thought I had to do some serious hacking – I was telneting into my router and trying to edit my hosts file. Turns out, it is a lot easier than I thought. This part could vary depending on your router – I run a custom firmware on my router called dd-wrt  and there are a few others available like Tomato and FreeWRT. If you have any sort of dlink or linksys router, you are probably able to run a custom firmware – check into it.

The peice of the puzzle that we need on your router is called DNSmasq. If you are running a router with vanilla firmware, you will have to take a look and see if if it supports DNSmasq or some other version DNS masking. Please share in the comments if you know of a way for a specific router.

First thing we need to do is grab our computers local IP address. You can get this by going back into terminal/cmdline and typing ipconfig (ifconfig on mac). and looking for something that looks like 192.168.x.x. If your computer changes IP addresses frequently you may need to set a static IP for your home network, I’ve run this setup for over a year, event reformatting my mbp once and I’ve never had to set a static IP. [osx guide] [windows guide]

With your computer’s IP handy, Go ahead and log into your router (usually unless you have changed it) and look around for DNSmasq. in DD-WRT its located under services. Then you simply need to type the following into the box and make sure your settings line up with mine:


ss 2013-01-25 at 12.14.45 PM

Save your settings and you are ready to start testing your devices on your local network! I’ve been running this setup for about a year now and I’m really happy with it – would love to hear any other tips/tools you use that might make this easier to the average Joe. Good luck!

This entry was posted in Mobile. Bookmark the permalink.

32 Responses to How to test localhost from any device on your network

  1. Josiah says:

    I’m biased, but I’m a bigger fan of Forward for serving something up over my localhost.

  2. Jitendra Vyas says:

    Is it mistake ? “I run MAMP to serve up both my static files and my static files”

  3. Hazem says:

    Personally I prefer to install a DNS server and use it for all devices DNS resolution this becomes handy for me as I use Linux all the time. This also allows me to test subdomains freely with the need to add a host for each domain.

  4. Esteaban Beltran says:

    Did you ever tried localtunnel? easier than all the DNS stuff but slower of course

  5. Howard says:

    WOW just whst I was searching for. Came here by searching for more helpful hints

  6. This is very interesting, You’re a very skilled blogger.
    I’ve joined your rss feed and look forward to seeking more of your magnificent post.

    Also, I’ve shared your website in my social networks!

  7. domain says:

    My partner and I stumbled over here different website and thought I might as well check things out.
    I like what I see so now i am following you.
    Look forward to looking at your web page repeatedly.

  8. james says:

    what about if I want it to resolve to, this being a website on localhost. What do I enter in the dnsmasq box


  9. Lovie says:

    I have read so many content regarding the blogger lovers
    except this post is truly a good piece of writing, keep it up.

  10. Hi, everything is going nicely here and ofcourse every one is
    sharing data, that’s in fact excellent, keep up writing.

  11. Ina says:

    Thanks for this. The setup is also similar on Tomato. Just a note on anyone using easyPHP on a Win machine, the firewall blocks incoming for Apache. Might save a lot of headache and the long way around if you find ping and nslookup are working, but it’s not resolving.

  12. Rafael says:

    Hi there! Thanks for that.
    I’m developing an android app to manage a device connected to the router at home. I was looking for a solution to access to this device from outside through the android app without do any port forwarding in the router.
    Is something I can do with this?

    Thanks in advance!

  13. Gratefull guy says:

    Great, thanks a lot for sharing!

  14. su ying says:

    Hi, thanks for this post and guide. I have some problem and question want to ask for your suggestion. currently i’m develop a mobile apps and i wish to do some testing. I’m able to surf the mobile apps through browser using ip and port number. once i deploy/download the apps into my smartphone and how should i retrieve and send those data into database? Can you guide me or provide some suggestion on this part?

  15. lollip says:

    can i do this setup in mikrotik router

  16. Azee says:

    Thanks, it was really helpful.

  17. Jeanie says:

    Thank you for sharing!! I’m building a website and really needed to test it on different sized screens. Looking forward to setting this up at home. Hopefully, I can do it correctly. Thanks much!

  18. Oscar says:

    Great, I can access localhost into my work but localhost in my home isn’t accessible, actually I can find DNSmasq option in my home’s router. Could my internet provider blocking the localhost access?

  19. mzk says:


    Interesting topic here. But, I rather prefer dnsmasq on Mac OS X to serve from my laptop to my local network. Easy config, few tweaks in CLI but very effective and fast!
    Have a look…

  20. Havilah says:

    Hello, I have XAMP installed – after following the guide here test.com resolves to my IIS local host. My xamp listens at port 85 – what am I supposed to do to point to it?

  21. wondеrful publish, very іnformative. I ponder why the opposite eхperts of this
    ѕector don’t realiᴢe this. You must continue your writing.

    I’m ѕure, you have a great readеrs’ base already!

  22. What DNSMasq? BTW great tutorial

  23. SophieFKhiev says:

    Greetings! Very beneficial advice in this particular article!
    It is the little changes that produce the main changes.
    Thanks a good deal for sharing!

  24. Really cool tutorial, definitely helpful for testing my applications server. Thank you so much!

  25. Stephan says:

    How to connect Android app to server on Local host:
    1st. Using:- (Using my IPv4) . . .
    Or. . . .
    2nd.Using:- Localhost:8080
    . . . . Or. . . .
    3rd. USING:-

    Main Problem is:-

    MY app does connect on server using 1st option on EMULATOR BUT when i try to run on Real device it throws connection timed out exception after 7 seconds As I’m giving it setTimeOut(7000) Is there any solution? I have read hundreds of post on the Internet about this problem but haven’t found a perfect solution!!!

    Even my device can’t load a simple webpage from local host from this address

  26. Yoսr means of Ԁescribing the wҺole thing in this paragraph is actually nice, every one can simpⅼy be aware of іt, Thanks a lot.

  27. outlook says:

    great article thank you for sharing this it tells us how to test localhost from any device on our network.
    If anyone has query related to Outlook support system contact us outlook Support

  28. Binosh R says:

    Thank you for sharing this information, I found it useful, Keep up writing

  29. Ranjith says:

    Its cool, i just so happy that i found it. Than you Mate.

Leave a Reply

Your email address will not be published. Required fields are marked *