Small library to manage virtual servers.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Small library to manage virtual servers.

The following operations are supported:

  • Start
  • Stop (safe, issues shutdown command first)
  • Shutdown (safe, issues shutdown command to server before powering off)
  • Hard stop
  • Update cores and RAM based on configured 'profiles'
  • Get basic server status information (state, cores, RAM)
  • Run commands on groups of servers via custom configured groups
  • Operate on servers in different datacenters

Both a CLI executable and a Node.js library are provided.


git clone
cd pb-server
npm install
cp config.sample.js config.js

Edit config.js to taste.

See config.sample.js for a fully commented explanation of the various configuration options.



For commands on individual (or groups of configured) servers.

Run pb without arguments for script usage.

The CLI executable supports configuring 'groups' in the config file which allow commands to be run on multiple servers at once.

As a node module.

var PbServer = require('./pb-server');
var config = require('./config');
var pb = new PbServer(config.pb, config.ssh);

// Server labels are the keys as defined in config.js, 'servers' object.
var serverName = 'serverLabelOne';
var cb = function(err, data) {
  if (err) {
    console.log(format("ERROR: %s, %s", err, data));
pb.getServer(serverName, cb);

See pb-server.js for all currently supported methods, and pb for more usage examples.

Shell completion

The provided pb.bash_completion can be used to enable shell completion for BASH.


The issue tracker for this project is provided to file bug reports, feature requests, and project tasks -- support requests are not accepted via the issue tracker. For all support-related issues, including configuration, usage, and training, consider hiring a competent consultant.