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.
This repository contains thoughts for a new version of Cozy Cloud which aims to be simpler for hosting thousands of instances. It should also bring multi-users for self-hosted and improve many things, starting with security and reliability. You can find:
- some notes about the architecture
- some code in Go to help me immerse in the new architecture.
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.
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
Install go, version >= 1.7. With go installed and configured, you can run the following command:
go get github.com/cozy/cozy-stack
This will fetch the sources in $GOPATH/src/github.com/cozy/cozy-stack 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.
export PATH="$GOPATH:$PATH"
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 a dev instance:
cozy-stack instances add dev # assuming couchdb is runningThen run the server with:
cozy-stack serveThe 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.
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 github.com/cozy/cozy-stack
cd $GOPATH/src/github.com/cozy/cozy-stack
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 http://127.0.0.1:6060/pkg/github.com/cozy/cozy-stack/You can reach the Cozy Community by:
- Chatting with us on IRC #cozycloud on irc.freenode.net
- 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.