The module that manages your applications on your Cozy Platform.
JavaScript CSS Shell
Pull request Compare This branch is 330 commits ahead, 9 commits behind nodejitsu:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Cozy Controller

The Cozy Controller is used to fetch and manage the applications in the Cozy Platform.

The Cozy Controller is a clone of Haibu by Nodejistu augmented with features required by the Cozy use cases, like:

  • configurable application directory
  • configurable application file permissions
  • applications are started in a given order.
  • Update application without loading a full reinstallation process.

You can specify options in file configuration located at:


Options available :

  • npm-registry: registry used for npm
  • strict-ssl: option strict-ssl for npm
  • timeout-autostart-home: maximum time between applications starting and home starting during autostart
  • timeout-autostart-ds: time to consider data-system broken during autostart

If you want further details, check out the wiki or Haibu original documentation



npm install cozy-controller -g


cozy-controller --jh

Run following command to see all available actions:

cozy-controller --help


You can contribute to the Cozy Controller in many ways:

  • Pick up an issue and solve it.
  • Add support for Python applications.
  • Add support for serverless applications.


First you have to create two folders:

mdkir /etc/cozy
chown myuser: /etc/cozy
mkdir ~/cozy-apps/

Then you can fetch sources and run the controller locally.

git clone
cd cozy-controller
chmod +x ./bin/cozy-controller
./bin/cozy-controller --dir ~/cozy-apps


Build Status

To run tests type the following command into the Cozy Home folder:

npm test


Cozy Controller is developed by Cozy Cloud and distributed under the AGPL v3 license.

What is Cozy?

Cozy Logo

Cozy is a platform that brings all your web services in the same private space. With it, your web apps and your devices can share data easily, providing you with a new experience. You can install Cozy on your own hardware where no one profiles you.


You can reach the Cozy Community by:

  • Chatting with us on IRC #cozycloud on
  • Posting on our Forum
  • Posting issues on the Github repos
  • Mentioning us on Twitter