Nextcloud Documentation

The context_agent app enables AI agent functionality within Nextcloud's "Chat with AI" feature. It serves as the backend for the Nextcloud Assistant app.

Key capabilities include:

• Tools: Virtual integrations that allow the AI Assistant to interact with other Nextcloud apps and perform actions based on chat instructions.
• MCP Server: Exposes all available tools via a Model Context Protocol (MCP) server, allowing you to connect third-party AI agents to your Nextcloud tools.

Nextcloud is an open-source platform for file synchronization and content collaboration. The Server Administration Guide is designed for users who need to:

• Install Nextcloud Server
• Administer and manage a Nextcloud instance
• Optimize server performance

Nextcloud Server runs on Linux and consists of a backend server, a responsive web client, cross-platform desktop clients (Windows, macOS, Linux), mobile clients (Android, iOS), and an app ecosystem.

Nextcloud provides full support for Collabora Online as an office solution. Users can integrate Collabora Online in two ways:

1. Self-hosted server: Connecting to an external Collabora Online server instance.
2. Built-in CODE (Collabora Online Development Edition) server: Using the dedicated Nextcloud server app that provides the Collabora engine directly within your Nextcloud environment.

For specific implementation details, refer to the installation, configuration, migration, and troubleshooting guides.

The Automatic Updater provides features and bug fixes for the Nextcloud synchronization client. Its behavior depends on the host OS:

• Windows: The client checks for and downloads updates automatically. If an update is downloaded, a silent update occurs before the next launch, followed by a restart. Administrative privileges are required for updates to succeed.
• macOS: Uses the Sparkle framework bundled in the App Bundle. It checks for updates on launch and presents a pop-up for one-click installation. If Sparkle is not bundled, a notification will open the download page in a web browser.
• Linux: The client does not perform updates itself; users must use their system's package manager. The client only provides notifications when a new version is available.

On all platforms, you can view the current update status in the client under Settings -> General -> Updates.

Nextcloud currently supports two primary methods for orchestrating application deployments as Docker containers via the Docker Deploy Daemon:

1. Docker Deploy Daemon (Docker Socket Proxy): Uses a proxy to manage Docker socket access.
2. Docker Deploy Daemon (HaRP): Requires the AppAPI HaRP component.

Administrators are responsible for the security configuration of the connected Docker daemon. The deployment schemes provided are examples of possible configurations.

The OCS Translation API enables translating strings between different languages.

Base URL: <nextcloud_base_url>/ocs/v2.php/translation/

Authentication Requirement: All calls to OCS endpoints must include the header OCS-APIRequest: true.

The Files Automated Tagging app allows you to assign collaborative tags to files and folders automatically based on predefined rules. This functions similarly to Nextcloud's Access Control system.

Key Use Cases

• Indirectly assigning restricted/invisible tags: Users can upload files that automatically receive tags they cannot remove. This is critical for enforcing retention policies and access control, as it prevents users from bypassing security measures by simply deleting a tag.
• Automated workflows: You can trigger actions (such as convert to PDF) based on the tags assigned to a file.

Dependency Injection (DI) is a design pattern where an object's dependencies are provided from the outside (usually by a container) rather than being instantiated internally. In Nextcloud, the App Framework uses a container to assemble applications, which promotes modularity, testability, and decoupling from internal server details.

Key Benefits:

• Testability: Easily swap real services with mock objects for unit testing.
• Maintainability: Centralized object creation means changes to a dependency's construction only need to be updated in one place.
• Explicitness: Dependencies are clearly defined in constructors or method signatures.
• Resource Efficiency: Reduces memory and resource usage by managing service lifecycles.

Nextcloud uses events to facilitate communication across its ecosystem, including internal server operations, server-to-app communication, and inter-app communication. There are three primary mechanisms for handling events:

1. OCP event dispatcher: Used for core server event dispatching.
2. Hooks: A mechanism for intercepting or reacting to specific execution points.
3. Public Emitter: A mechanism for broadcasting events to external consumers or apps.