Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Masquerade your dns records right to the apps
branch: master
Failed to load latest commit information.
bin Bump up to 2.0.0
config Bump up to 2.0.0
lib Bump up to 2.0.0
test Bump up to 2.0.0
.gitignore Initial commit
Gemfile Initial commit
LICENSE Initial commit Bump up to 2.0.0
Rakefile Initial commit
masquito.gemspec Bump up to 2.0.0


This gem is for DNS masquerading for rubists. Everyone knows Pow, but what I really don't like that it uses node.js to run Ruby applications. Sometimes we have to run our apps on the certain domain. Masquito allows you to do it, you can create dns records in the similar Pow's way by creating symbolic links to your apps or just empty files in .masquito directory.


Symbolic links were used by Pow in order to refer your application that will be run automatically, since Masquito doesn't run applications and does just DNS masquerading it's simplier to create just empty files. Check out another gem for full Pow's replacement.


First of all, uninstall Pow if you have it installed. I suppose you're on rbenv (honestly I haven't checked rvm support).

Install gem:

$ gem install masquito
$ rbenv rehash

Run this:

$ sudo masquito install

This command installs masquito server as a daemon that your system will start every boot. This daemon will respond on DNS queries from your system and monitor ~/.masquito directory for newly created domains.


Once you have installed masquito you can add domains to ~/.masquito

$ cd ~/.masquito
$ touch

It will create for you domain with the wild card for all subdomains and you can already ping and use it for the development.

$ ping
PING ( 56 data bytes
64 bytes from icmp_seq=0 ttl=53 time=1 ms

$ ping
PING ( 56 data bytes
64 bytes from icmp_seq=0 ttl=53 time=1 ms

Run your favorite application server manually, open up your browser and fill in address with port, that's all.

Something went wrong with that request. Please try again.