Manage your Cozy

Cozy management


To update the whole stack and all application, run the following commands directly on your server.

sudo cozy-monitor update-all-cozy-stack
sudo cozy-monitor update-all
sudo supervisorctl restart cozy-controller

Application update

To update a single application, you can run the following command on your target server.

sudo cozy-monitor update <app>


Restart cozy stack. Cozy stack means home, proxy and data-system. In others words, cozy stack corresponds to applications allow to run Cozy.

sudo cozy-monitor restart-cozy-stack


Display installed application with their status (up or down).

cozy-monitor status

Display cozy stack modules version

cozy-monitor versions-stack

Also display installed applications versions

cozy-monitor versions

Applications management


Install given application. If it is not an official Cozy application you should give repo location too. You should also give a specific display name or a specific branch.

sudo cozy-monitor install <app> [-r <repo>] [-d <displayName>] [-b <branch>]


Stop application with given name.

sudo cozy-monitor stop <app>

Stop all user applications.

sudo cozy-monitor stop-all <app>

Start application with given name.

sudo cozy-monitor start <app>

Restart application with given name.

sudo cozy-monitor restart <app>

Update application with given name (git clone + npm install + restart). The repo option is only useful if application comes from a specific repository.

sudo cozy-monitor update <app> [repo]

Update all applications installed by cozy user.

sudo cozy-monitor update-all


Uninstall application with given name.

sudo cozy-monitor uninstall <app>

Database management

By default, database option is "cozy".

Run compact CouchDB command on database (remove unused revisions).

sudo cozy-monitor compact [database]

Compact a given CouchDB view.

sudo cozy-monitor compact-views <view> [database]

Compact all views.

sudo cozy-monitor compact-all-views [database]

Backup database by replicating it to another CouchDB instance.

sudo cozy-monitor backup [target]

Clean database.

sudo cozy-monitor cleanup [database]

Provide more disk space

All data and files are stored in CouchDB. So, the simplest way to add more disk space is to change your CouchDB configuraion. Currently your data are saved in that folder:


This path can also be /var/lib/couchdb, in particular if your cozy is installed on Debian or Ubuntu.

You could change that directory where you want, on a mounting point with more free disk space. For that, open the following file:


It's /etc/couchdb/local.init on Debian and Ubuntu.

Add the couchdb section if it is not already present. Then you can change the database directory parameters:

database_dir = /home/storage/cozy-data
view_index_dir = /home/storage/cozy-data

Once done, you will have to stop couchdb, move your database file then restart it (as root):

service couchdb stop
mkdir /home/storage/cozy-data/
# cp here, to have a copy of the data in case of problem.
cp /usr/local/var/lib/couchdb/* /home/storage/cozy-data/
chown -R couchdb:couchdb /home/storage/cozy-data/ # Rights required.
service couchdb start

For Debian and Ubuntu, Couchdb is not managed by supervisord:

service couchdb stop
mkdir /home/storage/cozy-data/
# cp here, to have a copy of the data in case of problem.
cp /var/lib/couchdb/* /home/storage/cozy-data/
chown -R couchdb:couchdb /home/storage/cozy-data/ # Rights required.
service couchdb start

A backup is strongly recommended before performing that operation. You could either backup the database files or replicate the database to another Couchdb instance.

Use a Let’s Encrypt certificate

See this post on our blog that explains how to generate, install and renew a free certificate on your server with Let’s encrypt.


Increase max upload size

If you’re using Nginx as a reverse proxy in front of Cozy, you may notice that you’re not allowed to upload big files. By default, Nginx limit the maximum size of a client request to 1Mo. To increase this limit, just add a client_max_body_size to your Nginx config.

Reset internal routes

Ask for proxy to reset its routes via the information stored in the Data System.

sudo cozy-monitor reset-proxy