Github url


by typicode

typicode /hotel

🏩 A simple process manager for developers. Start apps from your browser and access them using local...

9.2K Stars 406 Forks Last release: Not found MIT License 714 Commits 81 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

hotel Mac/Linux Build Status Windows Build status

Start apps from your browser and use local domains/https automatically

Tip: if you don't enable local domains, hotel can still be used as a catalog of local servers.

Hotel works great on any OS (macOS, Linux, Windows) and with all servers :heart:* Node (Express, Webpack) * PHP (Laravel, Symfony) * Ruby (Rails, Sinatra, Jekyll) * Python (Django) * Docker * Go * Apache, Nginx * ...

To all the amazing people who have answered the Hotel survey, thanks so much <3 !

v0.8.0 upgrade




local domain and is the new default. See for context.

If you're upgrading, please be sure to: 1. Remove

"tld": "dev"

from your


file 2. Run

hotel stop && hotel start
  1. Refresh your network settings


If you are benefiting from hotel, you can support its development on Patreon.

You can view the list of Supporters here



  • Local domains -
  • HTTPS via local self-signed SSL certificate -
  • Wildcard subdomains -
  • Works everywhere - macOS, Linux and Windows
  • Works with any server - Node, Ruby, PHP, ...
  • Proxy - Map local domains to remote servers
  • System-friendly - No messing with
    port 80
    or additional software
  • Fallback URL -
  • Servers are only started when you access them
  • Plays nice with other servers (Apache, Nginx, ...)
  • Random or fixed ports


npm install -g hotel && hotel start

Hotel requires Node to be installed, if you don't have it, you can simply install it using one of the following method:

You can also visit

Quick start

Local domains (optional)

To use local


domains, you need to configure your network or browser to use hotel's proxy auto-config file or you can skip this step for the moment and go directly to http://localhost:2000

See instructions here.

Add your servers

# Add your server to hotel ~/projects/one$ hotel add 'npm start' # Or start your server in the terminal as usual and get a temporary local domain ~/projects/two$ hotel run 'npm start'

Visit localhost:2000 or http(s)://hotel.localhost.

Alternatively you can directly go to

http://localhost:2000/one http://localhost:2000/two
http(s)://one.localhost http(s)://two.localhost

Popular servers examples

Using other servers? Here are some examples to get you started :)

hotel add 'ember server' # Ember hotel add 'jekyll serve --port $PORT' # Jekyll hotel add 'rails server -p $PORT -b' # Rails hotel add 'python -m SimpleHTTPServer $PORT' # static file server (Python) hotel add 'php -S$PORT' # PHP hotel add 'docker-compose up' # docker-compose hotel add 'python runserver$PORT' # Django # ...

On Windows use


instead of


See a Docker example here..

Proxy requests to remote servers

Add your remote servers

~$ hotel add --name aliased-address ~$ hotel add --name aliased-domain

You can now access them using

http://aliased-address.localhost # will proxy requests to http://aliased-domain.localhost # will proxy requests to

CLI usage and options

hotel add <cmd> [opts]
hotel run <cmd> [opts]

# Examples

hotel add 'nodemon app.js' --out dev.log # Set output file (default: none)
hotel add 'nodemon app.js' --name name # Set custom name (default: current dir name)
hotel add 'nodemon app.js' --port 3000 # Set a fixed port (default: random port)
hotel add 'nodemon app.js' --env PATH # Store PATH environment variable in server config
hotel add --name app # map local domain to URL

hotel run 'nodemon app.js' # Run server and get a temporary local domain

# Other commands

hotel ls # List servers
hotel rm # Remove server
hotel start # Start hotel daemon
hotel stop # Stop hotel daemon

To get help

hotel --help hotel --help <cmd>




to work, your servers need to listen on the PORT environment variable. Here are some examples showing how you can do it from your code or the command-line:

var port = process.env.PORT || 3000 server.listen(port)
hotel add 'cmd -p $PORT' # OS X, Linux hotel add "cmd -p %PORT%" # Windows

Fallback URL

If you're offline or can't configure your browser to use


domains, you can always access your local servers by going to localhost:2000.

Configurations, logs and self-signed SSL certificate

You can find hotel related files in



~/.hotel/conf.json ~/.hotel/daemon.log ~/.hotel/ ~/.hotel/key.pem ~/.hotel/cert.pem ~/.hotel/servers/<app-name>.json

By default,


uses the following configuration values:

{ "port": 2000, "host": '', // Timeout when proxying requests to local domains "timeout": 5000, // Change this if you want to use another tld than .localhost "tld": 'localhost', // If you're behind a corporate proxy, replace this with your network proxy IP (example: "") "proxy": false }

To override a value, simply add it to


and run

hotel stop && hotel start

Third-party tools


Setting a fixed port

hotel add --port 3000 'server-cmd $PORT'



headers to requests

hotel add --xfwd 'server-cmd'






flag when adding your server or edit your server configuration in

hotel add --http-proxy-env 'server-cmd'

Proxying requests to a remote



hotel add --change-origin ''

_When proxying to a


server, you may get an error because your


domain doesn't match the host defined in the server certificate. With this flag,


header is changed to match the target URL._





If you're seeing one of these errors in


, this usually means that there's some permissions issues.


daemon should be started without




should belong to



# to fix permissions sudo chown -R $USER: $HOME/.hotel

See also,

Configuring a network proxy IP

If you're behind a corporate proxy, replace


with your network proxy IP in


. For example:

{ "proxy": "" }



Patreon - Supporters

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.