open source deployment platform for node.js, mongo and redis formerly
JavaScript HTML Other
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A hostable gui for deployment management of Node.js, MongoDB, and Redis apps on Ubuntu servers.

Formerly, this project was open sourced and the website was shutdown because I do not have time to maintain it. Apologies to the users.


A proxy and api for running node apps on a slave VPS.

How it works

diagram of paastor setup

Managing servers via gui

screenshot of paastor gui

Deploy with the command line tool

pstr push my-server myapp

Development and Running Locally


  • node.js
  • mongodb
  • gulp


git clone
cd paastor && npm install
cd sheep && npm install

sheep is an express app inside the paastor directory, hence the double npm install.


npm start


npm run debug-start



will watch and perform tasks like recompiling jade and client JS.

Default Server Locations

  • paastor is at localhost:2999
  • sheep proxy is at localhost:3001 in development and localhost:80 in production
  • sheep api is at localhost:3000

Default Services

Install mongodb and redis via gui.


  • header Paastor-Secret is sent during paastor --> sheep api communications.
    • secret is stored hashed and salted on sheep, by sheep, inside system.json.
    • secret is stored in paastor database under the Vps.secret property
    • YOU set the secret when creating a Vps
    • To tell sheep to reset and hash the secret, start the instance with an environment variable HASH_RESET= and your new secret. cd /path/to/sheep && HASH_RESET=asdfpassword npm start

System Settings

  • email Login email address.
  • name System informational name.
  • password Hashed login password.
  • sshkey Generated from the paastor gui. System public ssh key - add this to your git repos.


First add a vps for testing at spec/vps-credentials.json and set up paastor (http://localhost:2999/), then add paastor credentials at spec/paastor-credentials.json.

An example file is at spec/vps-credentials.json.example.

Running the Tests
npm test

If you have problems, try

npm run debug-test

for more verbose output.

If tests fail, you might end up with node processes that have gone rogue. Find them and stop them:

ps -l | grep node

kill [pid goes here]


Deploying sheep to the static site

From the root directory of paastor:


will do it.


MIT - see LICENSE file in this repository

Copyright 2015 Jeff H. Parrish