github.com/cozy/cozy-stack@v0.0.0-20240603063001-31110fa4cae1/README.md (about)

     1  Cozy Cloud
     2  ==========
     3  
     4  [![go.dev reference](https://pkg.go.dev/badge/github.com/cozy/cozy-stack)](https://pkg.go.dev/github.com/cozy/cozy-stack)
     5  [![Build Status](https://github.com/cozy/cozy-stack/workflows/CI/badge.svg)](https://github.com/cozy/cozy-stack/actions)
     6  [![Go Report Card](https://goreportcard.com/badge/github.com/cozy/cozy-stack)](https://goreportcard.com/report/github.com/cozy/cozy-stack)
     7  
     8  
     9  ## What is Cozy?
    10  
    11  ![Cozy Logo](https://cdn.rawgit.com/cozy/cozy-guidelines/master/templates/cozy_logo_small.svg)
    12  
    13  [Cozy](https://cozy.io) is a platform that brings all your web services in the
    14  same private space. With it, your web apps and your devices can share data
    15  easily, providing you with a new experience. You can install Cozy on your own
    16  hardware where no one profiles you.
    17  
    18  
    19  ## What is the Cozy-Stack
    20  
    21  It is the core server of the Cozy platform. It consists of a single process, *the Cozy stack*. 
    22  
    23  [Full Cozy-Stack documentation here](https://docs.cozy.io/en/cozy-stack/).
    24  
    25  The Cozy-Stack is in charge of serving the Web applications users have installed from the application store.
    26  
    27  It provides its services through a REST API that allows to:
    28  
    29   - create, update, delete documents inside the database;
    30   - authenticate users and client applications;
    31   - send emails;
    32   - 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).
    33   - …
    34  
    35  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.
    36  
    37  Two authentication methods are available:
    38  
    39   - Web applications running on the server get a session token when the user log in;
    40   - OAuth2 for other applications.
    41  
    42  Feel free to [open an issue](https://github.com/cozy/cozy-stack/issues/new)
    43  for questions and suggestions.
    44  
    45  
    46  ## Installing a `cozy-stack`
    47  
    48  You can follow the [Install guide](docs/INSTALL.md) and the [configuration
    49  documentation](docs/config.md).
    50  
    51  
    52  ## How to contribute?
    53  
    54  We are eager for contributions and very happy when we receive them! It can be
    55  code, of course, but it can also take other forms. The workflow is explained
    56  in [the contributing guide](docs/CONTRIBUTING.md).
    57  
    58  
    59  ## Community
    60  
    61  You can reach the Cozy Community by:
    62  
    63  * Chatting with us on IRC #cozycloud on [Libera.Chat](https://web.libera.chat/#cozycloud)
    64  * Posting on our [Forum](https://forum.cozy.io)
    65  * Posting issues on the [Github repos](https://github.com/cozy/)
    66  * Mentioning us on [Twitter](https://twitter.com/cozycloud)
    67  
    68  
    69  ## License
    70  
    71  Cozy is developed by Cozy Cloud and distributed under the AGPL v3 license.