Install Cozy on Debian

You need Debian 8 Jessie (stable) in order to proceed to theses steps.

root@debian-8:~# lsb_release -c
Codename:     jessie

If lsb_release is not installed, you are probably on a too old version of Debian. You can see which version like this:

root@debian-8:~# cat /etc/debian_version

Cozy needs a web server. By default, we will install and configure Nginx, but if a web server is already installed, you can use it, just add a virtual host for Cozy.

  1. Make sure that wget, ca-certificates and apt-transport-https are properly installed
     apt-get install wget ca-certificates apt-transport-https
  2. Import the repository public key
     wget -O - 2>/dev/null | apt-key add -
  3. Optionally check that the imported key is valid
     apt-key --keyring /etc/apt/trusted.gpg finger
    You should read:
     pub   2048R/2765B235 2014-11-17 [expires: 2016-11-17]
           Key fingerprint = E28C F8B2 ABBF E285 743B  27F1 BCB2 ED5D 2765 B235
     uid                  Cozy Debian Packaging <>
     sub   2048R/D58A9D35 2014-11-17 [expires: 2016-11-17]
  4. Add the Cozy repository to your software sources
     echo 'deb jessie cozy' \
     > /etc/apt/sources.list.d/cozy.list
  5. Install Cozy
     apt-get update ;
     apt-get install python-cozy-management ;
     cozy_management install_cozy
    (please read comment bellow about the recommended dependencies).
  6. Start Nginx service
     service nginx start
  7. Register your Cozy account and enjoy!


Some words about the dependencies

Cozy requires a CouchDB database, which will be automatically installed. It also needs a SMTP server listening on port 25 of the same host, and a Web server acting as a reverse proxy. Both are only recommended dependencies, because, depending on your architecture, you may install them on other server. For example, you can use a reverse proxy hosted on another server in front of your Cozy. However, for a typical installation, you should probably install the recommended dependency, by using apt-get install --install-recommends cozy.

The recommended packages are:

How to regenerate the certificate?

sudo openssl req -x509 -nodes -newkey rsa:2048 -keyout /etc/cozy/server.key -out /etc/cozy/server.crt -days 3650 -subj "/CN=YOUR.INSTANCE.URL"

Debian 8: wrong nodejs version?

Cozy now requires nodejs 4.x, and actually the cozy_management installer includes a step that:

The thing is, Debian 8 (Jessie) already has its own repository for nodejs, containing a quite old version (0.10.x). If you have once installed that old version, the Cozy installer won't be able to install the newer, and the whole installation will crash, with no other message than:

update-alternatives: error: alternative link /usr/bin/node is already managed by nodejs
dpkg: error processing package nodejs (--configure): subprocess installed post-installation script returned error exit status 2

Even if you used apt-get purge nodejs to uninstall the old nodejs, there are still some traces in the alternative system. So, to make sure there are no traces of nodejs left on your Debian, you can trust this StackOverflow question and use update-alternatives --remove-all nodejs, then Cozy installation should be able to install nodejs 4.x properly and to continue as expected.