From f7757a440f12db6e80fc7601532d340a66ec1947 Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Mon, 12 Oct 2026 18:06:17 +0200 Subject: [PATCH 1/4] add requirements for the clients --- docs/admin/getting-started/requirements.md | 40 ++++++++++++++++++++++ docs/user/android-app/index.md | 2 ++ docs/user/desktop-client/linux/index.md | 2 ++ docs/user/desktop-client/macos/index.md | 2 ++ docs/user/desktop-client/windows/index.md | 2 ++ docs/user/ios-app/index.md | 2 ++ 6 files changed, 50 insertions(+) diff --git a/docs/admin/getting-started/requirements.md b/docs/admin/getting-started/requirements.md index 02d5e84ed..22732aaf0 100644 --- a/docs/admin/getting-started/requirements.md +++ b/docs/admin/getting-started/requirements.md @@ -6,9 +6,49 @@ description: Runs on anything from a Raspberry Pi to a data center. draft: false --- +## Server Requirements + | Category | Details | | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Server Operating System | | | Database | | | Storage | | | Hardware requirements | Minimum (Minimal bare-metal Deployment - Up to 10 Users) Medium (Deployment - Up to 1,000 Users) General: | + +## Client Requirements + +### Web Client + +The OpenCloud Web Client requires a supported web browser. Supported versions follow the OpenCloud Web browser policy and exclude versions classified as end-of-life. + +| Browser | Supported versions | +| :-------------- | :-------------------------------------------------------------------------------- | +| Google Chrome | Releases from the last year or versions with over 0.2% global usage | +| Mozilla Firefox | Firefox ESR, releases from the last year, or versions with over 0.2% global usage | +| Microsoft Edge | Releases from the last year or versions with over 0.2% global usage | +| Apple Safari | Releases from the last year or versions with over 0.2% global usage | + +### Desktop Client + +The OpenCloud Desktop Client is designed for file synchronization on local desktop computers and is not intended for use in Virtual Desktop Infrastructure (VDI) environments. + +The following requirements are based on the ownCloud Desktop documentation and are provisional until confirmed by the OpenCloud Desktop developers. + +| Operating system | Supported versions | +| :------------------------------ | :------------------------------------------------------------------------------------------------------------- | +| Windows (x64) | Windows 10 (version 1809 or later), Windows 11 | +| macOS (Intel and Apple Silicon) | macOS 13 or later | +| Linux (x86-64) | Latest two versions of supported distributions and the previous Ubuntu LTS release, where technically feasible | + +For installation and setup information, see the [Desktop Client documentation](../../user/desktop-client/). + +### Mobile Apps + +OpenCloud provides mobile apps for Android and iOS/iPadOS. + +| Platform | Minimum supported OS version | +| :----------- | :--------------------------- | +| Android | Android 8.0 or later | +| iOS / iPadOS | iOS 15.4 or later | + +For installation and setup information, see the [Android App documentation](../../user/android-app/) and [iOS App documentation](../../user/ios-app/). diff --git a/docs/user/android-app/index.md b/docs/user/android-app/index.md index 3e1468277..21c6e1f93 100644 --- a/docs/user/android-app/index.md +++ b/docs/user/android-app/index.md @@ -8,6 +8,8 @@ title: OpenCloud Android App The OpenCloud Android app provides mobile access to your files, spaces, and shares. It is designed for quick access on the go, with support for setup, search, shortcuts, and file management. +Before installing the app, review the [mobile app requirements](../../admin/getting-started/requirements.md#mobile-apps). + ## What you will find here - [General](./general/) diff --git a/docs/user/desktop-client/linux/index.md b/docs/user/desktop-client/linux/index.md index 651c78aed..59a1311d2 100644 --- a/docs/user/desktop-client/linux/index.md +++ b/docs/user/desktop-client/linux/index.md @@ -8,6 +8,8 @@ title: Desktop Client for Linux The OpenCloud Desktop Client for Linux allows you to synchronize files between your Linux system and your OpenCloud instance. This section guides you through the complete lifecycle of the Desktop Client, from installation and initial setup to synchronization settings, application preferences, and upgrading to newer versions. +Before installing the client, review the [Desktop Client requirements](../../../admin/getting-started/requirements.md#desktop-client). + ## In this section - [Installation](./installation.md) diff --git a/docs/user/desktop-client/macos/index.md b/docs/user/desktop-client/macos/index.md index d880c1de7..b0df20e01 100644 --- a/docs/user/desktop-client/macos/index.md +++ b/docs/user/desktop-client/macos/index.md @@ -8,6 +8,8 @@ title: Desktop Client for macOS The OpenCloud Desktop Client for macOS allows you to synchronize files between your Mac and your OpenCloud instance. This section guides you through the complete lifecycle of the Desktop Client, from installation and initial setup to synchronization settings, application preferences, and upgrading to newer versions. +Before installing the client, review the [Desktop Client requirements](../../../admin/getting-started/requirements.md#desktop-client). + ## In this section - [Installation](./installation.md) diff --git a/docs/user/desktop-client/windows/index.md b/docs/user/desktop-client/windows/index.md index a8be1692b..4f4759932 100644 --- a/docs/user/desktop-client/windows/index.md +++ b/docs/user/desktop-client/windows/index.md @@ -8,6 +8,8 @@ title: Desktop Client for Windows The OpenCloud Desktop Client for Windows allows you to synchronize files between your Windows device and your OpenCloud instance. This section guides you through the complete lifecycle of the Desktop Client, from installation and initial setup to synchronization settings, application preferences, and upgrading to newer versions. +Before installing the client, review the [Desktop Client requirements](../../../admin/getting-started/requirements.md#desktop-client). + ## In this section - [Installation](./installation.md) diff --git a/docs/user/ios-app/index.md b/docs/user/ios-app/index.md index ea003f13e..00e4b6716 100644 --- a/docs/user/ios-app/index.md +++ b/docs/user/ios-app/index.md @@ -8,6 +8,8 @@ title: OpenCloud iOS App The OpenCloud iOS app provides mobile access to your files, Spaces, and shares on iPhone and iPad. It is designed for everyday tasks such as setup, searching, sharing, and making files available offline. +Before installing the app, review the [mobile app requirements](../../admin/getting-started/requirements.md#mobile-apps). + ## In this section - [General](./general/) From 578c57805223cffefc632ec2cbeff4b6f39c5d46 Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Wed, 14 Oct 2026 10:55:08 +0200 Subject: [PATCH 2/4] remove the 0,2% part for web --- docs/admin/getting-started/requirements.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/admin/getting-started/requirements.md b/docs/admin/getting-started/requirements.md index 22732aaf0..8aa51e863 100644 --- a/docs/admin/getting-started/requirements.md +++ b/docs/admin/getting-started/requirements.md @@ -21,12 +21,12 @@ draft: false The OpenCloud Web Client requires a supported web browser. Supported versions follow the OpenCloud Web browser policy and exclude versions classified as end-of-life. -| Browser | Supported versions | -| :-------------- | :-------------------------------------------------------------------------------- | -| Google Chrome | Releases from the last year or versions with over 0.2% global usage | -| Mozilla Firefox | Firefox ESR, releases from the last year, or versions with over 0.2% global usage | -| Microsoft Edge | Releases from the last year or versions with over 0.2% global usage | -| Apple Safari | Releases from the last year or versions with over 0.2% global usage | +| Browser | Supported versions | +| :-------------- | :------------------------------------------ | +| Google Chrome | Releases from the last year | +| Mozilla Firefox | Firefox ESR and releases from the last year | +| Microsoft Edge | Releases from the last year | +| Apple Safari | Releases from the last year | ### Desktop Client From 5536bba0412e0323c1a2c460e997dd8371f26d7d Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Mon, 26 Oct 2026 08:12:35 +0100 Subject: [PATCH 3/4] add client requirements to version 7.2 --- .../admin/getting-started/requirements.md | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/versioned_docs/version-7.2/admin/getting-started/requirements.md b/versioned_docs/version-7.2/admin/getting-started/requirements.md index 02d5e84ed..8aa51e863 100644 --- a/versioned_docs/version-7.2/admin/getting-started/requirements.md +++ b/versioned_docs/version-7.2/admin/getting-started/requirements.md @@ -6,9 +6,49 @@ description: Runs on anything from a Raspberry Pi to a data center. draft: false --- +## Server Requirements + | Category | Details | | :---------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Server Operating System |
  • Production: Linux
  • Testing and development: MacOS or Windows WSL
| | Database |
  • None (OpenCloud stores files exclusively on the storage to minimize complexity and ensure maximum reliability)
| | Storage |
  • The `posix` and `decomposed` storage drivers require:
    • a fully POSIX compliant filesystem
      • local e.g. ext4, XFS, ZFS
      • network e.g. CephFS, GPFS, NFS v4.2 or later
    • atomic read after write consistency for directory metadata (NFS mount option `noac`)
  • `decomposeds3` additionally requires an S3 bucket
  • `posix` requires extended attributes (offloading metadata >1KB into dedicated files)
| | Hardware requirements | Minimum (Minimal bare-metal Deployment - Up to 10 Users)
  • eg. Raspberry Pi 3
  • 1 GHz (Single-core)
  • 512 MB Ram
  • Storage: depends on data usage
Medium (Deployment - Up to 1,000 Users)
  • 2 GHz (Dual-core)
  • 8 GB Ram
  • Storage: depends on data usage
General:
  • Disk Performance (IOPS): Input/output operations per second (IOPS) should be unrestricted for maintaining optimal performance.
  • The server requirements vary based on load factors such as requests per second, number of client devices per user, file volume, post-processing tasks, and additional apps like Collabora. Proper sizing depends on these variables and should be adjusted accordingly.
| + +## Client Requirements + +### Web Client + +The OpenCloud Web Client requires a supported web browser. Supported versions follow the OpenCloud Web browser policy and exclude versions classified as end-of-life. + +| Browser | Supported versions | +| :-------------- | :------------------------------------------ | +| Google Chrome | Releases from the last year | +| Mozilla Firefox | Firefox ESR and releases from the last year | +| Microsoft Edge | Releases from the last year | +| Apple Safari | Releases from the last year | + +### Desktop Client + +The OpenCloud Desktop Client is designed for file synchronization on local desktop computers and is not intended for use in Virtual Desktop Infrastructure (VDI) environments. + +The following requirements are based on the ownCloud Desktop documentation and are provisional until confirmed by the OpenCloud Desktop developers. + +| Operating system | Supported versions | +| :------------------------------ | :------------------------------------------------------------------------------------------------------------- | +| Windows (x64) | Windows 10 (version 1809 or later), Windows 11 | +| macOS (Intel and Apple Silicon) | macOS 13 or later | +| Linux (x86-64) | Latest two versions of supported distributions and the previous Ubuntu LTS release, where technically feasible | + +For installation and setup information, see the [Desktop Client documentation](../../user/desktop-client/). + +### Mobile Apps + +OpenCloud provides mobile apps for Android and iOS/iPadOS. + +| Platform | Minimum supported OS version | +| :----------- | :--------------------------- | +| Android | Android 8.0 or later | +| iOS / iPadOS | iOS 15.4 or later | + +For installation and setup information, see the [Android App documentation](../../user/android-app/) and [iOS App documentation](../../user/ios-app/). From fea25eb842ee4dc94df5b2096a51c4e77e6ebfde Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Thu, 12 Nov 2026 15:09:16 +0100 Subject: [PATCH 4/4] add the VDI requirements for Desktop --- docs/admin/getting-started/requirements.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/docs/admin/getting-started/requirements.md b/docs/admin/getting-started/requirements.md index 8aa51e863..519484cf3 100644 --- a/docs/admin/getting-started/requirements.md +++ b/docs/admin/getting-started/requirements.md @@ -30,8 +30,6 @@ The OpenCloud Web Client requires a supported web browser. Supported versions fo ### Desktop Client -The OpenCloud Desktop Client is designed for file synchronization on local desktop computers and is not intended for use in Virtual Desktop Infrastructure (VDI) environments. - The following requirements are based on the ownCloud Desktop documentation and are provisional until confirmed by the OpenCloud Desktop developers. | Operating system | Supported versions | @@ -40,6 +38,22 @@ The following requirements are based on the ownCloud Desktop documentation and a | macOS (Intel and Apple Silicon) | macOS 13 or later | | Linux (x86-64) | Latest two versions of supported distributions and the previous Ubuntu LTS release, where technically feasible | +#### Virtual Desktop Infrastructure (VDI) + +The OpenCloud Desktop Client can be used in Virtual Desktop Infrastructure (VDI) environments. However, the following data locations must be handled consistently across sessions: + +- Windows Registry: Stores credentials and sidebar entries. +- User configuration directory: Stores the Desktop Client configuration. +- Synchronization directory: Contains locally synchronized files and folders. + +All three locations must either be preserved across sessions or completely cleared when a session is reset. Partially retained data may cause configuration or synchronization issues. + +:::caution + +If synchronized Spaces are deleted between VDI sessions, all metadata must be synchronized again. This can generate significant load on both the OpenCloud server and the client machine, especially for large Spaces. + +::: + For installation and setup information, see the [Desktop Client documentation](../../user/desktop-client/). ### Mobile Apps