Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cozy Documentation

Learn how to use Cozy, host your own server and develop applications.

Edit this documentation

This documentation is built with MkDocs.

All sources are in the dev branch and the master branch contains the "live" built site. The CI builds the site from the dev branch and automatically publish the built result in the master branch.


To edit the documentation, just edit the files inside src on the dev branch.

If you want to see your updates, install mkdocs:

In most linux distribution, it will install binary in ~/local/bin/, add it to your path.

Fetch external documentation and add it to mkdocs.yml (do not commit changes done in mkdocs.yml) :

# Activate a virtualenv if you want (recommended)
pip install -r requirements.txt

Expected python version is 3

Run MkDocs:

mkdocs serve

And point your favorite browser to

External documentations

External documentations are listed in the OUTSIDE_DOCS file. They are consolidated in this documentation during build. This lets developers edit their documentation in their repository while the single site makes it convenient to search for information only in one location.

Each repository maintains its own table of contents, which controls what is shown under the References menu.

See ./, and ./ scripts for more information.

The edit links displayed in the header of each article are modified via Javascript to handle outside repositories (mkdocs does not support this natively).

When are the docs deployed ?

The documentation build is triggerd automatically and built by Travis

  • when a commit is pushed on the dev branch
  • every day (since we cannot detect changes in external documentations)

After the build, it is available on

You can trigger a manual build on > More options > Trigger build.

Testing the statically built site

To test the whole site:

cd site/
python -m SimpleHTTPServer