Module used to install, update and remove applications in the Cozy Platform.

npm install cozy-controller
5 downloads in the last day
42 downloads in the last week
232 downloads in the last month

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



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
npm loves you