Skip to content

add requirements for the clients #1209

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Svanvith wants to merge 2 commits into
base: main
Choose a base branch
from
Open

add requirements for the clients #1209

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f7757a4
add requirements for the clients
Svanvith Oct 12, 2026
578c578
remove the 0,2% part for web
Svanvith Oct 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions docs/admin/getting-started/requirements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 | <ul><li>Production: Linux</li><li>Testing and development: MacOS or Windows WSL</li></ul> |
| Database | <ul><li>None (OpenCloud stores files exclusively on the storage to minimize complexity and ensure maximum reliability)</li></ul> |
| Storage | <ul><li>The `posix` and `decomposed` storage drivers require:<ul><li>a fully POSIX compliant filesystem <ul><li> local e.g. ext4, XFS, ZFS</li><li>network e.g. CephFS, GPFS, NFS v4.2 or later</li></ul></li><li>atomic read after write consistency for directory metadata (NFS mount option `noac`)</li></ul></li><li>`decomposeds3` additionally requires an S3 bucket</li><li>`posix` requires extended attributes (offloading metadata >1KB into dedicated files)</li></ul> |
| Hardware requirements | Minimum (Minimal bare-metal Deployment - Up to 10 Users) <ul><li>eg. Raspberry Pi 3</li><li>1 GHz (Single-core)</li><li>512 MB Ram</li><li>Storage: depends on data usage</li></ul> Medium (Deployment - Up to 1,000 Users) <ul><li>2 GHz (Dual-core)</li><li>8 GB Ram</li><li>Storage: depends on data usage</li></ul> General: <ul><li>Disk Performance (IOPS): Input/output operations per second (IOPS) should be unrestricted for maintaining optimal performance.</li><li>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.</li></ul> |

## 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/).
2 changes: 2 additions & 0 deletions docs/user/android-app/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
Expand Down
2 changes: 2 additions & 0 deletions docs/user/desktop-client/linux/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 2 additions & 0 deletions docs/user/desktop-client/macos/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 2 additions & 0 deletions docs/user/desktop-client/windows/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 2 additions & 0 deletions docs/user/ios-app/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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/)
Expand Down
Loading