# nextcloud/server architecture

> Architecture diagram of the GitHub repository nextcloud/server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nextcloud/server
- Repository: https://github.com/nextcloud/server

## Overview

Nextcloud Server is a self-hosted platform for storing, syncing, sharing, and protecting user data, with additional apps that extend its capabilities. The principal workflow is a user accessing files through the server, with storage, previews, and sharing supporting that access; the README also documents synchronization across devices. The tree and samples show platform APIs and selected app areas, not the complete runtime or all documented capabilities. Some edges therefore reflect README-level behavior, while unsampled app relationships are left unspecified.

Main entry points: [`lib/public/IUserSession.php`](https://github.com/nextcloud/server/blob/master/lib/public/IUserSession.php) (User session API), [`lib/public/Files/Storage/IStorage.php`](https://github.com/nextcloud/server/blob/master/lib/public/Files/Storage/IStorage.php) (Storage contract), [`lib/public/AppFramework/Controller.php`](https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Controller.php) (App framework), [`lib/private/Log.php`](https://github.com/nextcloud/server/blob/master/lib/private/Log.php) (Logging)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Server platform"]
  node_appframework["App framework<br/>[Controller.php]"]
  node_request["HTTP request API<br/>[IRequest.php]"]
  node_response["Response formatting<br/>[Controller.php]"]
  node_http["HTTP status API<br/>[Http.php]"]
  node_log["Logging<br/>[Log.php]"]
  node_user_manager["User management API<br/>[IUserManager.php]"]
end

subgraph group_files["File services"]
  node_files_api["File API<br/>[Node.php]"]
  node_folder_api["Folder API<br/>[Folder.php]"]
  node_root_folder["User file roots<br/>[IRootFolder.php]"]
  node_storage_api["Storage contract<br/>[IStorage.php]"]
  node_storage_wrapper["Storage wrapper<br/>[Wrapper.php]"]
  node_view["File view<br/>[View.php]"]
  node_external_storage["External storage admin"]
  node_preview_controller["Preview endpoints"]
  node_preview_manager["Preview generation<br/>[PreviewManager.php]"]
  node_preview_cache[("Preview metadata<br/>[Preview.php]")]
  node_trash["Trash and recovery<br/>[Storage.php]"]
  node_versions["File versions<br/>[Storage.php]"]
  node_cache_api["File cache API<br/>[ICache.php]"]
  node_preview_api["Preview API<br/>[IPreview.php]"]
end

subgraph group_apps["App ecosystem"]
  node_appstore["App discovery and management<br/>[AppstoreBrowse.vue]"]
  node_workflow["Workflow rules<br/>[workflowengine.ts]"]
end

subgraph group_collaboration["Collaboration"]
  node_sharing["File sharing<br/>[SharedStorage.php]"]
  node_comments["File comments<br/>[GetComments.ts]"]
  node_federation["Federated sharing API"]
end

subgraph group_security["Security"]
  node_audit["Audit events<br/>[AuditLogger.php]"]
  node_encryption["Encryption key management<br/>[KeyManager.php]"]
  node_session["User session API<br/>[IUserSession.php]"]
end

node_user(("User"))
node_devices(("User devices"))

node_user -->|"accesses files"| node_files_api
node_devices -->|"syncs data"| node_user
node_user -->|"shares data"| node_sharing
node_user -->|"discovers apps"| node_appstore
node_user -->|"protects data"| node_encryption
node_appframework -->|"receives requests"| node_request
node_appframework -->|"formats responses"| node_response
node_external_storage -->|"sets status"| node_http
node_storage_wrapper -->|"delegates operations"| node_storage_api
node_external_storage -.->|"configures mounts"| node_storage_api
node_preview_controller -->|"requests previews"| node_preview_api
node_preview_manager -->|"implements previews"| node_preview_api
node_preview_manager -->|"loads mapper"| node_preview_cache
node_files_api -->|"supports folders"| node_folder_api
node_root_folder -->|"extends folder"| node_folder_api
node_sharing -->|"uses storage wrappers"| node_storage_wrapper
node_versions -->|"uses file view"| node_view
node_versions -->|"uses storage interface"| node_storage_api
node_session -->|"authenticates"| node_user
node_log -->|"checks user session"| node_session
node_log -->|"reads request data"| node_request
node_user_manager -.->|"supports user identity"| node_session

click node_appframework "https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Controller.php"
click node_request "https://github.com/nextcloud/server/blob/master/lib/public/IRequest.php"
click node_response "https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Controller.php"
click node_http "https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Http.php"
click node_log "https://github.com/nextcloud/server/blob/master/lib/private/Log.php"
click node_files_api "https://github.com/nextcloud/server/blob/master/lib/public/Files/Node.php"
click node_folder_api "https://github.com/nextcloud/server/blob/master/lib/public/Files/Folder.php"
click node_root_folder "https://github.com/nextcloud/server/blob/master/lib/public/Files/IRootFolder.php"
click node_storage_api "https://github.com/nextcloud/server/blob/master/lib/public/Files/Storage/IStorage.php"
click node_storage_wrapper "https://github.com/nextcloud/server/blob/master/lib/private/Files/Storage/Wrapper/Wrapper.php"
click node_view "https://github.com/nextcloud/server/blob/master/lib/private/Files/View.php"
click node_external_storage "https://github.com/nextcloud/server/blob/master/apps/files_external/lib/Controller/StoragesController.php"
click node_preview_controller "https://github.com/nextcloud/server/blob/master/core/Controller/PreviewController.php"
click node_preview_manager "https://github.com/nextcloud/server/blob/master/lib/private/PreviewManager.php"
click node_preview_cache "https://github.com/nextcloud/server/blob/master/lib/private/Preview/Db/Preview.php"
click node_sharing "https://github.com/nextcloud/server/blob/master/apps/files_sharing/lib/SharedStorage.php"
click node_trash "https://github.com/nextcloud/server/blob/master/apps/files_trashbin/lib/Storage.php"
click node_versions "https://github.com/nextcloud/server/blob/master/apps/files_versions/lib/Storage.php"
click node_appstore "https://github.com/nextcloud/server/blob/master/apps/appstore/src/views/AppstoreBrowse.vue"
click node_workflow "https://github.com/nextcloud/server/blob/master/apps/workflowengine/src/workflowengine.ts"
click node_comments "https://github.com/nextcloud/server/blob/master/apps/comments/src/services/GetComments.ts"
click node_federation "https://github.com/nextcloud/server/blob/master/apps/cloud_federation_api/lib/Controller/OCMRequestController.php"
click node_audit "https://github.com/nextcloud/server/blob/master/apps/admin_audit/lib/AuditLogger.php"
click node_encryption "https://github.com/nextcloud/server/blob/master/apps/encryption/lib/KeyManager.php"
click node_session "https://github.com/nextcloud/server/blob/master/lib/public/IUserSession.php"
click node_cache_api "https://github.com/nextcloud/server/blob/master/lib/public/Files/Cache/ICache.php"
click node_preview_api "https://github.com/nextcloud/server/blob/master/lib/public/IPreview.php"
click node_user_manager "https://github.com/nextcloud/server/blob/master/lib/public/IUserManager.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_appframework,node_request,node_response,node_http,node_log,node_user_manager,node_user,node_devices toneBlue
class node_files_api,node_folder_api,node_root_folder,node_storage_api,node_storage_wrapper,node_view,node_external_storage,node_preview_controller,node_preview_manager,node_preview_cache,node_trash,node_versions,node_cache_api,node_preview_api toneAmber
class node_appstore,node_workflow toneMint
class node_sharing,node_comments,node_federation toneRose
class node_audit,node_encryption,node_session toneIndigo
```

## Components

### Server platform

- [App framework](https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Controller.php): `lib/public/AppFramework/Controller.php`
- [HTTP request API](https://github.com/nextcloud/server/blob/master/lib/public/IRequest.php): `lib/public/IRequest.php`
- [Response formatting](https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Controller.php): `lib/public/AppFramework/Controller.php`
- [HTTP status API](https://github.com/nextcloud/server/blob/master/lib/public/AppFramework/Http.php): `lib/public/AppFramework/Http.php`
- [Logging](https://github.com/nextcloud/server/blob/master/lib/private/Log.php): `lib/private/Log.php`
- [User management API](https://github.com/nextcloud/server/blob/master/lib/public/IUserManager.php): `lib/public/IUserManager.php`

### File services

- [File API](https://github.com/nextcloud/server/blob/master/lib/public/Files/Node.php): `lib/public/Files/Node.php`
- [Folder API](https://github.com/nextcloud/server/blob/master/lib/public/Files/Folder.php): `lib/public/Files/Folder.php`
- [User file roots](https://github.com/nextcloud/server/blob/master/lib/public/Files/IRootFolder.php): `lib/public/Files/IRootFolder.php`
- [Storage contract](https://github.com/nextcloud/server/blob/master/lib/public/Files/Storage/IStorage.php): `lib/public/Files/Storage/IStorage.php`
- [Storage wrapper](https://github.com/nextcloud/server/blob/master/lib/private/Files/Storage/Wrapper/Wrapper.php): `lib/private/Files/Storage/Wrapper/Wrapper.php`
- [File view](https://github.com/nextcloud/server/blob/master/lib/private/Files/View.php): `lib/private/Files/View.php`
- [External storage admin](https://github.com/nextcloud/server/blob/master/apps/files_external/lib/Controller/StoragesController.php): `apps/files_external/lib/Controller/StoragesController.php`
- [Preview endpoints](https://github.com/nextcloud/server/blob/master/core/Controller/PreviewController.php): `core/Controller/PreviewController.php`
- [Preview generation](https://github.com/nextcloud/server/blob/master/lib/private/PreviewManager.php): `lib/private/PreviewManager.php`
- [Preview metadata](https://github.com/nextcloud/server/blob/master/lib/private/Preview/Db/Preview.php): `lib/private/Preview/Db/Preview.php`
- [Trash and recovery](https://github.com/nextcloud/server/blob/master/apps/files_trashbin/lib/Storage.php): `apps/files_trashbin/lib/Storage.php`
- [File versions](https://github.com/nextcloud/server/blob/master/apps/files_versions/lib/Storage.php): `apps/files_versions/lib/Storage.php`
- [File cache API](https://github.com/nextcloud/server/blob/master/lib/public/Files/Cache/ICache.php): `lib/public/Files/Cache/ICache.php`
- [Preview API](https://github.com/nextcloud/server/blob/master/lib/public/IPreview.php): `lib/public/IPreview.php`

### App ecosystem

- [App discovery and management](https://github.com/nextcloud/server/blob/master/apps/appstore/src/views/AppstoreBrowse.vue): `apps/appstore/src/views/AppstoreBrowse.vue`
- [Workflow rules](https://github.com/nextcloud/server/blob/master/apps/workflowengine/src/workflowengine.ts): `apps/workflowengine/src/workflowengine.ts`

### Collaboration

- [File sharing](https://github.com/nextcloud/server/blob/master/apps/files_sharing/lib/SharedStorage.php): `apps/files_sharing/lib/SharedStorage.php`
- [File comments](https://github.com/nextcloud/server/blob/master/apps/comments/src/services/GetComments.ts): `apps/comments/src/services/GetComments.ts`
- [Federated sharing API](https://github.com/nextcloud/server/blob/master/apps/cloud_federation_api/lib/Controller/OCMRequestController.php): `apps/cloud_federation_api/lib/Controller/OCMRequestController.php`

### Security

- [Audit events](https://github.com/nextcloud/server/blob/master/apps/admin_audit/lib/AuditLogger.php): `apps/admin_audit/lib/AuditLogger.php`
- [Encryption key management](https://github.com/nextcloud/server/blob/master/apps/encryption/lib/KeyManager.php): `apps/encryption/lib/KeyManager.php`
- [User session API](https://github.com/nextcloud/server/blob/master/lib/public/IUserSession.php): `lib/public/IUserSession.php`

### Other components

- **User**
- **User devices**

## Connections

- User → File API: accesses files (evidence: `README.md`)
- User devices → User: syncs data (evidence: `README.md`)
- User → File sharing: shares data (evidence: `README.md`)
- User → App discovery and management: discovers apps (evidence: `README.md`)
- User → Encryption key management: protects data (evidence: `README.md`)
- App framework → HTTP request API: receives requests (evidence: `lib/public/AppFramework/Controller.php`)
- App framework → Response formatting: formats responses (evidence: `lib/public/AppFramework/Controller.php`)
- External storage admin → HTTP status API: sets status (evidence: `apps/files_external/lib/Controller/StoragesController.php`)
- Storage wrapper → Storage contract: delegates operations (evidence: `lib/private/Files/Storage/Wrapper/Wrapper.php`)
- External storage admin → Storage contract: configures mounts
- Preview endpoints → Preview API: requests previews (evidence: `core/Controller/PreviewController.php`)
- Preview generation → Preview API: implements previews (evidence: `lib/private/PreviewManager.php`)
- Preview generation → Preview metadata: loads mapper (evidence: `lib/private/PreviewManager.php`)
- File API → Folder API: supports folders (evidence: `lib/public/Files/Folder.php`)
- User file roots → Folder API: extends folder (evidence: `lib/public/Files/IRootFolder.php`)
- File sharing → Storage wrapper: uses storage wrappers (evidence: `apps/files_sharing/lib/SharedStorage.php`)
- File versions → File view: uses file view (evidence: `apps/files_versions/lib/Storage.php`)
- File versions → Storage contract: uses storage interface (evidence: `apps/files_versions/lib/Storage.php`)
- User session API → User: authenticates (evidence: `lib/public/IUserSession.php`)
- Logging → User session API: checks user session (evidence: `lib/private/Log.php`)
- Logging → HTTP request API: reads request data (evidence: `lib/private/Log.php`)
- User management API → User session API: supports user identity
