Cozy is a free, open source file management & sync project written in Go and released under AGPL-3.0. It has 1,269 GitHub stars, 141 forks and 56 open issues, and was last pushed 12 hours ago. On this registry it ranks #10 of 12 tracked projects in File Management & Sync, with 5 head-to-head comparisons available.

What is Cozy?

What it is

Cozy is a platform that brings web services into one private space. Cozy-Stack is the core server of the Cozy platform, and it runs as a single process. The project is written in Go, is developed by Twake Workplace, and is distributed under the AGPL v3 license. It lives in the self-hosted personal cloud ecosystem, and it targets users who want to install software on their own hardware instead of relying on a third-party profile.

The concrete problem is data fragmentation across web apps and devices. Cozy-Stack serves installed web applications, exposes a REST API for document operations, and lets client applications sync data with the server. This gives a private space where web apps and devices can share data, while the operator keeps control over the hardware and the data.

Key capabilities

  • Cozy-Stack serves web applications that users install from the application store.
  • The REST API creates, updates, and deletes documents inside the database.
  • The server authenticates users and client applications with session tokens and OAuth2.
  • The server can send emails and launch jobs for one-time or periodic tasks.
  • Connectors can import data from remote websites as jobs executed on the server.
  • Jobs that execute third-party code on the server side are sandboxed with nsjail.
  • The database replication API syncs documents between the server and local databases, including mobile clients.

Who uses it and how

  • Self-hosters install Cozy on their own hardware to keep web services in a private space without profiling.
  • Users access installed web applications through the Cozy-Stack server and its application store.
  • Client applications use OAuth2 and the REST API to work with documents stored on the Cozy instance.
  • Data-import workflows use connectors, which run as server jobs and can be sandboxed when they execute third-party code.
  • Mobile clients use the replication API to keep local databases synchronized with the Cozy server.

Getting started

The provided README points to docs/INSTALL.md for installation and docs/config.md for configuration. It does not list Docker image names, package managers, or a hosted option.

When to use it — and when not to

Cozy fits self-hosters who want a private platform for installed web apps, document sync, connectors, and authenticated client applications. The operator must still run and configure the underlying database, email sending, and job execution path, and the provided README gives no Docker or hosted deployment shortcut. The supplied metadata shows a repository age of 0 years, 0 contributors, and 56 open issues, so teams that need clear maintenance history or fast setup may need to review the project carefully.

project readme (upstream, from github) — read inline

Twake Workplace

go.dev reference Build Status Go Report Card

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.

What is the Cozy-Stack

It is the core server of the Cozy platform. It consists of a single process, the Cozy stack.

Full Cozy-Stack documentation here.

The Cozy-Stack is in charge of serving the Web applications users have installed from the application store.

It provides its services through a REST API that allows to:

  • create, update, delete documents inside the database;
  • authenticate users and client applications;
  • send emails;
  • launch jobs on the server. Connectors that import data from remote websites are some sort of jobs. Jobs can be one time tasks (sending a message) or periodic tasks. Some jobs, like the connectors, that require executing third party code on the server side, are sandboxed (we use nsjail for now).

The Cozy-Stack also allows to access the database replication API, allowing to sync documents between the server and local databases, for example in mobile clients.

Two authentication methods are available:

  • Web applications running on the server get a session token when the user log in;
  • OAuth2 for other applications.

Feel free to open an issue for questions and suggestions.

Installing a cozy-stack

You can follow the Install guide and the configuration documentation.

How to contribute?

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

Community

You can reach the Cozy Community by:

License

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

Frequently asked questions

Is Cozy free to use?

Cozy is open source under the AGPL-3.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Cozy do?

Your secure French personal cloud for complete data control

What is Cozy written in?

Cozy is primarily written in Go. Its source is publicly available at https://github.com/cozy/cozy-stack, and it has 1,269 GitHub stars.