# linagora/cozy-stack

Simple, Versatile, Yours

Repository: https://github.com/linagora/cozy-stack
Canonical: https://ross.abutalabs.com/products/cozy-stack
Homepage: https://docs.cozy.io/en/cozy-stack/
Language: Go
License: AGPL-3.0
License Family: copyleft
Topics: cozy, couchdb, simple, versatile, yours, cozy-v3
Last push: 2026-09-02T16:31:50+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 94, longevity 100
- inputs: {"age_days": 3701, "days_push": 0, "days_rel": 41, "gap_med": 13.5, "n_releases_24m": 31}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1270, forks 141 (observed 2026-09-03T02:15:14.458330+00:00)

## What it is
Cozy-stack is the core backend server of the Cozy/Twake Workplace personal cloud platform, written in Go. It serves user-installed web apps, exposes a REST API over CouchDB documents, handles authentication (sessions and OAuth2), sends emails, runs sandboxed jobs and data-importing connectors, and provides database replication for mobile clients.

## Use cases
- self-host a personal cloud for my files, contacts, and photos
- run a private alternative to Google Drive with web apps
- sync documents between a server and mobile clients
- build connectors that import data from remote websites into my personal space
- host web applications with OAuth2 authentication for third-party clients
- run scheduled and one-off background jobs on my own server
- store and query structured documents via a REST API backed by CouchDB

## When to choose
- you want a self-hosted personal cloud platform with an app store ecosystem
- you need CouchDB-backed document storage with replication to mobile clients
- you want to build konnectors that scrape or import data from external services
- you value data sovereignty and hosting web services on your own hardware
- you need OAuth2 and session-based auth plus email and job scheduling out of the box

## When to avoid
- you need a simple file-sync server without an app platform (use Nextcloud or Syncthing instead)
- you don't want to operate CouchDB and Node.js 20 as dependencies
- you need a lightweight single-purpose backend rather than a full platform stack
- your project requires a permissive license, since cozy-stack is AGPL-3.0

## Facets
- artifact type: service
- maturity: active
- function: http-server, auth, database, web-framework, email, scheduling, self-hosted, api-framework, cli
- domain: self-hosted, backend, web-development, privacy, developer-tools, apis
- platform: go, self-hosted, cli
- tags: personal-cloud, couchdb, oauth2, pims, konnectors, data-sovereignty, rest-api, agpl, linux, docker, web-server

## Member repositories
- linagora/cozy-stack (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:14.458330+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:03:22.262709+00:00, confidence not recorded.
  - readme: https://github.com/linagora/cozy-stack (fetched 2026-09-03T02:15:14.458330+00:00, sha f3c37fabfef9)
  - homepage: https://docs.cozy.io/en/cozy-stack/ (fetched 2026-08-29T12:14:50.546824+00:00, sha bd4543ac9770)
  - site_page: https://docs.cozy.io/en/tutorials/client-side-konnector/installation (fetched 2026-08-29T12:14:50.559907+00:00, sha a818bc0ead0a)
  - site_page: https://docs.cozy.io/en/tutorials/client-side-konnector/clisk-lib-doc (fetched 2026-08-29T12:14:50.561686+00:00, sha ead4eb00c34d)
  - site_page: https://docs.cozy.io/en/tutorials/selfhosting/requirements/couchdb (fetched 2026-08-29T12:14:50.564369+00:00, sha 7407cb94689c)
  - site_page: https://docs.cozy.io/en/cozy-client/getting-started (fetched 2026-08-29T12:14:50.556094+00:00, sha f8b53b0489d6)
  - site_page: https://docs.cozy.io/en/tutorials/konnector/getting-started (fetched 2026-08-29T12:14:50.558281+00:00, sha ff120a24e483)
  - site_page: https://docs.cozy.io/en/tutorials/selfhosting/requirements/nodejs (fetched 2026-08-29T12:14:50.566213+00:00, sha 5c5e58be25be)
  - site_page: https://docs.cozy.io/en/tutorials/selfhosting/install (fetched 2026-08-29T12:14:50.567872+00:00, sha 20492485c6f9)
  - site_page: https://docs.cozy.io/en/tutorials/selfhosting/install/package (fetched 2026-08-29T12:14:50.569499+00:00, sha fa939c75ade9)
- Data as of 2026-08-30T08:39:29.467469+00:00.