zoltar launches your node-powered sites on demand when you access them by their actual names. No more "node app", no more "http://localhost:3000".
zoltar also provides a simple web-based console where you can see the output of all of your apps and easily shut them down, launch more, or visit their homepages.
Move your node-powered sites to
~/node-sites (or not, see "Changing the Configuration"). Each one should have an
app.js file. The layout looks like this:
~/node-sites/site1/app.js ~/node-sites/site2/app.js ~/node-sites/site3/app.js
Etc. Don't put anything that isn't a node-powered website in this folder.
server.js are also accepted, as well as anything specified as
If you want a custom startup just for Zoltar, you can have that too. Just provide a bash script called
start-dev and make sure it's executable, and Zoltar will run that instead.
For instance, you might choose to make sure Express runs in debug mode with a
start-dev file like this:
#!/bin/bash# Run the app in debug modeDEBUG=express:* node app
Again, make sure you
chmod 700 start-dev so that the script is executable.
PORTenvironment variable and listen on that port. (If you have ever developed for Heroku you may already be doing this. Some high-level libraries, like
apostrophe-site, do it out of the box.)
```js app.listen(process.env.PORT || 3000); ```
That will listen on port 3000 if
PORT is not set.
zoltar from github.
cd to the folder and run
git clone https://github.com/punkave/zoltar cd zoltar npm install
Now start the proxy:
configure your system to use the provided
proxy.pac file for webserver proxy configuration. All the major web browsers provide a way to do this, so this works across Windows, Linux and Mac. On a Mac you can just do it system-wide:
Now, try visiting one of your sites! If you have
~/node-sites/site1/app.js then you can visit:
(Note: Chrome will be a pain at first and insist you don't really mean it if you just type site1.dev without the http. But it'll get over it after it sees you mean it the first couple times.)
Boom! Your site fires up in the background and you see the homepage.
You can see all the console output of each site. There is an "x" to shut each site down.
And, if you click one of the tabs at right for sites not already running, they start up and open in your browser.
If you double-click the tab for a site that is already running, a new browser window is opened to visit that site.
Just click the "↺" icon.
config-example.js for configurable parameters. Copy that file to
config.js and it will take effect. If you change the proxy port you must also change it in
proxy.pac and you may need to select that file again in your operating system's network control panel.
Note that you can change the
nodeCommand parameter to start your apps via
forever instead of
zoltar was created at P'unk Avenue to support our work developing projects with Apostrophe, an open-source content management system built on node.js.
zoltar isn't mandatory for Apostrophe and vice versa, but they play very well together. If you like
zoltar you should definitely check out the Apostrophe sandbox project.
First off: thanks to
proxy.pac zoltar only looks at .dev sites and keeps its filthy mitts completely off the rest of your web traffic. So if a website is not working, don't blame zoltar. It wasn't even there, okay?
Having said that... feel free to open issues on github. We welcome pull requests.