2.5.22 • Public • Published

Cozy Home

Cozy Home is your dashboard to access and manage all your Cozy apps. It allows you to install, update and remove any app. It provides you too a tile page on which you can organize all your application launchers and widgets.


We assume here that the Cozy platform is correctly installed on your server.

Type this command to install the home application:

cozy-monitor install home


You can contribute to the Cozy Home in many ways:

  • Pick up an issue and solve it.
  • Translate it in a new language (ask us to be added to the contributors, we will also help you to make your first steps with transifex).
  • Add the capability to backup the Cozy (replicate it to another Cozy instance from) from the User Interface.


To be hacked, the Cozy Home dev environment requires that a CouchDB instance and a Cozy Data System instance are running, as furbish by the development VM.

First, clone the repo:

git clone
cd cozy-home
npm install

To launch a development-aware processes, simply run:

npm run watch

You can now point your browser to http://localhost:9103 to access your dev instance.


Each modification requires a new build, here is how to run a build:

npm run build
npm start



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

cake tests

In order to run the tests, you must only have the Data System started:

git clone
cd cozy-data-system/
npm install
TOKEN=token NODE_ENV=test DB_NAME=home_test npm start


Here are the source for the backgrounds:

Contribute with Transifex

Transifex can be used the same way as git. It can push or pull translations. The config file in the .tx repository configure the way Transifex is working : it will get the json files from the client/app/locales repository. If you want to learn more about how to use this tool, I'll invite you to check this tutorial.


Cozy Home 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




Package Sidebar


npm i cozy-home

Weekly Downloads






Last publish


  • mycozycloud