Simple, Versatile, Yours
Go Shell Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Cozy Cloud

GoDoc Build Status codecov

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.

And what about this repository?

This repository contains the new version of Cozy Cloud which aims to be simpler for hosting thousands of instances. It should also bring for the self-hosted the possibility to host several instances on the same server, and improve many things, starting with security and reliability.

Feel free to open an issue for questions and suggestions.


  • CouchDB 2.0.0

To install CouchDB 2.0.0 through Docker, take a look at our Docker specific documentation.

Installing a cozy-stack

We do not yet provide releases binaries, but we will soon and you won't have to install go in order to run cozy-stack

Using go

Install go, version >= 1.7. With go installed and configured, you can run the following command:

go get

This will fetch the sources in $GOPATH/src/ and build a binary in $GOPATH/bin/cozy-stack.

Don't forget to add your $GOPATH to your $PATH in your *rc file so that you can execute the binary without entering its full path.


Add an instance and run

You can configure your cozy-stack using a configuration file or different comand line arguments. You can have more informations on our Configuration page.

Assuming CouchDB is installed and running on default port 5984, you can start the server:

cozy-stack serve

And then create an instance for development:

cozy-stack instances add --dev "localhost:8080"

The cozy-stack server listens on http://localhost:8080/ by default. See cozy-stack --help for more informations.

Make sure the full stack is up with:

curl -H 'Accept: application/json' 'http://localhost:8080/status/'


See configuration documentation.

How to contribute?

We are eager for contributions and very happy when we receive them! It can code, of course, but it can also take other forms. The workflow is explained in the contributing guide.

There are some useful commands to know in order to develop with the go code of cozy-stack:

go get -u
cd $GOPATH/src/

go get -t -u ./...      # To install or update the go dependencies
go test -v ./...        # To launch the tests
go run main.go serve    # To start the API server
godoc -http=:6060       # To start the documentation server
                        # Open


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


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