node package manager


API to perform Ubuntu Server admin tasks via HATEOS or Websockets

Ubuntu Server API

HTTP friendly API (HATEOS or Websockets) for admining remote Ubuntu servers. Designed to support Ubuntu Server GUI.

Status - Developer Preview

Early version of the app I'm releasing to get developer feedback. It has the basic architecture in place and PAM authentication. For now I only recommend running it on local testing/development servers.

Auto Install (recommended)

sudo curl -L | sudo bash

Manual Install

sudo apt-get install -y build-essential python-software-properties python-pycurl
sudo add-apt-repository -y ppa:richarvey/nodejs && apt-get update
sudo apt-get install -y nodejs nodejs-dev npm libsqlite3-dev libpam0g-dev
sudo apt-get install -y ubuntu-server-api

Install For Developers

git clone ubuntu-server-api
cd ubuntu-server-api
sudo npm install -g --unsafe-perm

Install Notes

currently tested with Ubuntu Server versions (11.04, 11.10, 12.04 and 12.10).


  • written with Mocha and Should
  • run them from the root directory via make test


  • for now the tests and source code are the best documentation
  • pretty documentation is coming soon


AGPL 3.0