nserv

Nserv wants to be a Nodejitsu / Heroku / No.de style PaaS for deploying node.js applciations which can be hosted on your own servers. Nserv uses nodejitsu applications forever and node-http-proxy so is running entirely on nodejs. A total works in progress, probably with a lot of bugs.

Features:

• Git deployment of applications
• Simple management of deployed applications

Setup:

• Create a fresh ubuntu 10.04 instance, linode or rackspace is good: http://library.linode.com/getting-started##sph_deploy-a-linux-distribution
• Point a domain name to your server or add one to /etc/hosts: http://jorgebernal.info/2009/07/17/42foo-virtual-hosts-web-development/
• sudo npm install forever -g
• sudo npm install nserv -g

Usage:

nserv start - starts running the nserv service at localhost:8080 nserv stop
nserv create (domain) - this will add the domain to nserv proxy table and start proxying requests
nserv remove (domain)
nserv list - lists all applications
nserv help

You must first start the nserv server: nserv start, this will create a http proxy table and route any domains added to it via: nserv create domain.com.

After creating an application you will be shown a git remote within the console that you can add to your local repo. Once added execute git push nserv master and your app will be updated and restarted automatically.

For now your main server file must be called 'server.js' and your app must listen on process.env.PORT. If you provide a package.json file for npm modules add a .gitignore file to remove your node_modules folder. Npm is installed on nserv and installs dependencies automatically.

TODO:

• Define the main server.js in the package.json
• Automatic install of npm modules
• Hard start and stop of applications (without the need to delete or update)

Good stuff:

npm
nodejitsu

License

(The MIT License)

Copyright (c) 2011 Bradley Griffiths <bradley.griffiths@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.