Created: 2011-07-15 15:42
Updated: 2016-06-06 17:21
License: mit



Haibu Drone's Little Shell

What is Carapace

Carapace is an process wrapper for Node.js applications that is part of the Haibu Network. Carapace also provides a plugin system to simplify deployment and development of applications.

What can I do with Carapace?

By utilizing Carapace you can help automate deployments of applications into a custom environment. Combining Carapace with the Forever Daemon can allow you run the application in the environment indefinitely.

Carapace CLI Options

carapace --plugin [plugin] --[plugin] [options] application [options]


--plugin [plugin]

Plugin to use with the carapace instance

Plugin Options

--[plugin] [options]

Option to be passed to the [plugin]

Application & Application's Options

[application] [application's CLI options]

Any options that isn't consumed by the Carapace will automatically be passed to the application

Default Plugins

List of known plugins, and options (if any) used by them

  • chdir - directory to change into
  • heartbeat - time in micro-seconds between 'carapace::heartbeat' events
  • coffee - spawn .coffee files
  • setuid - set the uid of the spawned process
  • net - automatically listen on a new port if EADDRINUSE is thrown


  $ [sudo] npm install haibu-carapace

Run Tests

All of the carapace tests are written in vows

  $ npm test

Author: Nodejitsu Inc.

Maintainers: Charlie Robbins, Bradley Meck, Jameson Lee

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more