Classy process manager for web devs โค
No need to worry about ports, remember commands, manage terminal tabs, ... access and start your servers from the browser. You can even use local .dev
domains and it works everywhere ๐
- Shortcut access (
http://localhost:2000/project
) - Local domain support (
http://project.dev
*) - Servers are only started when you access them
- Random or fixed ports
- Works with any server (Node, Ruby, PHP, ...)
- Cross-platform (OS X, Linux and Windows)
- Plays nice with other servers (Apache, Nginx, ...)
- No port 80 or admin/root privileges needed
(*) Local .dev
domains are optional. If you want to use them, you need to configure your browser or network to use hotel's proxy auto-config file (proxy.pac
). See instructions here.
npm install -g hotel && hotel start
Add your servers commands.
~/projects/one$ hotel add nodemon
~/projects/two$ hotel add 'serve -p $PORT'
Now, you can access, start and stop your servers from localhost:2000.
As a shortcut, you can also directly go to:
http://localhost:2000/one
http://localhost:2000/two
Other servers examples:
hotel add 'jekyll --port $PORT'
hotel add 'rails server --port $PORT'
hotel add 'python -m SimpleHTTPServer $PORT'
hotel add 'php -S 127.0.0.1:$PORT'
# ...
On Windows use "%PORT%"
instead of '$PORT'
To add a server
hotel add <cmd> [opts]
# Examples:
hotel add 'nodemon app.js' -o out.log # Set output file (default: none)
hotel add 'nodemon app.js' -n name # Set custom name (default: current dir name)
hotel add 'nodemon app.js' -p 3000 # Set a fixed port (default: random port)
hotel add 'nodemon app.js' -e PATH # Store PATH environment variable in server config
To list, start and stop servers go to
http://localhost:2000
To start and access directly your server go to
http://localhost:2000/<app-name>
Other commands
hotel ls # List servers
hotel rm [name] # Remove server
hotel start # Start daemon
hotel stop # Stop daemon
For hotel
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
See instructions here.
~/.hotel
contains daemon log, servers and daemon configurations.
~/.hotel/conf.json
~/.hotel/daemon.log
~/.hotel/servers/<app-name>.json
Hotel Clerk OS X menubar HotelX Another OS X menubar (only 1.6MB)
MIT - Typicode