Repolode
Submit
linagora

linagora/cozy-stack

Core server of the Cozy personal cloud platform, serving installed web apps and exposing a REST API for documents, auth, email and jobs.

Open-source alternative to:Google DriveiCloud

View on GitHubWebsite
Stars
1,268
Forks
144
Open issues
80
Last commit
14 hours ago

What is it?

Cozy Stack is the core server of the Cozy platform, a self-hostable personal cloud that brings web services and devices into one private space. It runs as a single process that serves the web applications users install from an application store.

The stack exposes a REST API for creating, updating and deleting documents in its database, authenticating users and client applications, and sending emails. It also runs jobs on the server, including one-time tasks and periodic tasks such as connectors that import data from remote websites. Jobs that execute third-party code are sandboxed with nsjail.

The server supports database replication so that local databases, such as those in mobile clients, can sync documents with the server. Web apps running on the server receive a session token at login, and other applications authenticate through OAuth2.

Key features

  • 01Runs installed web apps from an application store on a single server process.
  • 02Provides a REST API for document CRUD, user and client authentication, and email sending.
  • 03Runs one-time and periodic background jobs, with third-party connector code sandboxed by nsjail.
  • 04Supports database replication so local clients can sync with the server.
  • 05Offers session tokens for server-side apps and OAuth2 for other applications.

Use cases

  • Self-hosting a private personal cloud for storing and syncing your own data.
  • Building or hosting web apps on the Cozy platform that need a document database and auth.
  • Syncing documents between a server and mobile clients through the replication API.

Quick start

  1. 1

    Follow the install guide in docs/INSTALL.md

  2. 2

    Review the configuration documentation in docs/config.md

Things to know

  • The README gives no direct run command; setup is delegated to separate install and configuration guides.
  • It is a server core for a personal cloud platform, so self-hosting requires server setup effort.
  • Connectors that run third-party code rely on nsjail for sandboxing.

Topics

#self-hosted#personal-cloud#couchdb#rest-api#oauth2#go#cozy#cozy-v3#simple#versatile

FAQ

What is cozy-stack?
Core server of the Cozy personal cloud platform, serving installed web apps and exposing a REST API for documents, auth, email and jobs. Cozy Stack is the core server of the Cozy platform, a self-hostable personal cloud that brings web services and devices into one private space. It runs as a single process that serves the web applications users install from an application store.
Is cozy-stack free to use? What license does it have?
cozy-stack is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is cozy-stack still maintained?
Actively maintained. The last commit to cozy-stack was on Oct 19, 2026.
What can I use cozy-stack for?
Self-hosting a private personal cloud for storing and syncing your own data. Building or hosting web apps on the Cozy platform that need a document database and auth. Syncing documents between a server and mobile clients through the replication API.
How do I install cozy-stack?
Follow the install guide in docs/INSTALL.md Review the configuration documentation in docs/config.md
Where can I get cozy-stack?
The source code and installation instructions are on GitHub: https://github.com/linagora/cozy-stack

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects