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

     1  ---
     2  title: Cozy-Stack documentation - Table of contents
     3  ---
     4  
     5  ## What is the Cozy-Stack?
     6  
     7  The cozy-stack is the main backend server for the Cozy platform.
     8  
     9  [Full Cozy-Stack documentation here](https://docs.cozy.io/en/cozy-stack/).
    10  
    11  The Cozy-Stack is in charge of serving / running the applications users have installed on their Cozy.
    12  
    13  It is in charge of:
    14  
    15   - creating, updating, deleting documents inside the database;
    16   - authenticating users and client applications;
    17   - sending emails;
    18   - launching jobs on the server. Connectors that import data from remote websites are jobs. Jobs can be one time tasks (sending a message) or periodic tasks. Jobs that require executing third party code on the server side (like connectors), are sandboxed;
    19   - database replication API, allowing to sync documents between the server and local databases, for example in mobile clients.
    20  
    21  Feel free to [open an issue](https://github.com/cozy/cozy-stack/issues/new) for questions and suggestions.
    22  
    23  
    24  ## How-to guides
    25  
    26  ### Usage
    27  
    28  -   [Install the cozy-stack](INSTALL.md)
    29  -   [Configuration file](config.md)
    30  -   [Managing Instances](instance.md)
    31  -   [Security](security.md)
    32  -   [Manpages of the command-line tool](cli/cozy-stack.md)
    33  -   [Using the admin API](admin.md)
    34  -   [Important changes](important-changes.md)
    35  
    36  ### For developers
    37  
    38  -   [Using the HTTP API of cozy-stack](http-api.md)
    39  -   [Develop a client-side app](client-app-dev.md)
    40  -   [Develop a konnector](konnectors-dev.md)
    41  -   [Running and building Docker images](docker.md)
    42  -   [Adding a new doctype](doctype.md)
    43  -   [Working with the stack assets](assets.md)
    44  -   [Build a release](release.md)
    45  -   [The contributing guide](CONTRIBUTING.md)
    46  
    47  ## Explanation
    48  
    49  ### Up-to-date
    50  
    51  -   [Flagship app](flagship.md)
    52  -   [Move design](move-design.md)
    53  -   [Realtime internals](realtime-internals.md)
    54  -   [Sharing design](sharing-design.md)
    55  -   [Workflow of the konnectors](konnectors-workflow.md)
    56  
    57  ### Archives
    58  
    59  These pages are the results of studies we made. They may be outdated and are
    60  kept as an archive to help understanding what were out original intentions when
    61  designing new services.
    62  
    63  -   [General overview of the initial architecture](archives/architecture.md)
    64  -   [Onboarding with an application](archives/onboarding.md)
    65  -   [Moving](archives/moving.md)
    66  -   [Golang Couchdb Plugins](archives/couchdb-plugins.md)
    67  -   [Konnectors design](archives/konnectors-design.md)
    68  -   [Replication](archives/replication.md)
    69  -   [Realtime design](archives/realtime.md)
    70  
    71  ## Reference
    72  
    73  ### List of services
    74  
    75  -   `/auth` - [Authentication & OAuth](auth.md)
    76      -   [Delegated authentication](delegated-auth.md)
    77  -   `/apps` - [Applications Management](apps.md)
    78      -   [Apps registry](registry.md)
    79      -   [Konnectors](konnectors.md)
    80  -   `/bitwarden` - [Bitwarden](bitwarden.md)
    81  -   `/connection_check` - [Connection check](connection-check.md)
    82  -   `/contacts` - [Contacts](contacts.md)
    83  -   `/data` - [Data System](data-system.md)
    84      -   [Mango](mango.md)
    85      -   [CouchDB Quirks](couchdb-quirks.md) &
    86          [PouchDB Quirks](pouchdb-quirks.md)
    87  -   `/files` - [Virtual File System](files.md)
    88      -   [Not synchronized directories](not-synchronized-vfs.md)
    89      -   [References of documents in VFS](references-docs-in-vfs.md)
    90  -   `/intents` - [Intents](intents.md)
    91  -   `/jobs` - [Jobs](jobs.md)
    92      -   [Workers](workers.md)
    93  -   `/move` - [Move, export and import an instance](move.md)
    94  -   `/notes` - [Notes with collaborative edition](notes.md)
    95  -   `/notifications` - [Notifications](notifications.md)
    96  -   `/office` - [Collaborative edition of Office documents](office.md)
    97  -   `/permissions` - [Permissions](permissions.md)
    98  -   `/public` - [Public](public.md)
    99  -   `/realtime` - [Realtime](realtime.md)
   100  -   `/remote` - [Proxy for remote data/API](remote.md)
   101      -   [NextCloud](nextcloud.md)
   102  -   `/settings` - [Settings](settings.md)
   103      -   [Terms of Services](user-action-required.md)
   104  -   `/sharings` - [Sharing](sharing.md)
   105  -   `/shortcuts` - [Shortcuts](shortcuts.md)
   106  -   `/.well-known` - [Well-known](wellknown.md)