Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
9 changes: 9 additions & 0 deletions docs/user/desktop-client/common-functionality/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"label": "Common functionality",
"position": 4,
"link": {
"type": "generated-index",
"description": "Common functionalities for the OpenCloud Desktop Client.",
"slug": "user/desktop/common-functionality"
}
}
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 10
sidebar_position: 4
id: file-conflicts
title: Handle file conflicts
description: How to handle file conflicts
Expand All @@ -13,7 +13,7 @@ When files are modified both locally and remotely before synchronization, the De
- `conflict.txt` (remote version)
- `conflict (conflicted copy YYYY-MM-DD HHMMSS).txt` (local version)

<img src={require("./img/conflict-files/conflict-file.png").default} alt="Conflict files in explorer" width="1920"/>
<img src={require(".././img/conflict-files/conflict-file.png").default} alt="Conflict files in explorer" width="1920"/>

This usually happens when:

Expand All @@ -26,7 +26,7 @@ In the Desktop Client overview, a notification will appear when conflicting file
This means that multiple versions of the same file exist—often because changes were made on different devices before synchronization.
The notification serves as a prompt for you to review the conflicts and decide how to merge or keep the versions.

<img src={require("./img/conflict-files/conflict-info.png").default} alt="Notification about file conflicts in the Desktop Client" width="500"/>
<img src={require(".././img/conflict-files/conflict-info.png").default} alt="Notification about file conflicts in the Desktop Client" width="500"/>

## Resolve File Conflicts Manually

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 11
sidebar_position: 5
id: file-names
title: File Naming Rules
description: File Naming Rules for OpenCloud Desktop
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 5
sidebar_position: 1
id: logging
title: Collect Logfiles
description: Collect logfiles in OpenCloud
Expand All @@ -14,24 +14,24 @@ If you need to generate logs for troubleshooting, follow these steps:

- Click on Settings → Advanced → Log Settings

<img src={require("./img/logging/logging-access.png").default} alt="Logging access" width="400"/>
<img src={require(".././img/logging/logging-access.png").default} alt="Logging access" width="400"/>

## Enable Logging

- In the Log Output window, check the box for Enable logging to temporary folder
- To help the Support-Team and the developers, it is helpful to enable the Log Http traffic

<img src={require("./img/logging/logging-enable.png").default} alt="Enable logging" width="400"/>
<img src={require(".././img/logging/logging-enable.png").default} alt="Enable logging" width="400"/>

## Find the Log Files

- Click Open folder to access the logs.

<img src={require("./img/logging/logging-open-folder.png").default} alt="Open logfile folder" width="400"/>
<img src={require(".././img/logging/logging-open-folder.png").default} alt="Open logfile folder" width="400"/>

- Select the log files for the time frame when the issue occurred.

<img src={require("./img/logging/logging-logfiles.png").default} alt="Logfiles overview" width="400"/>
<img src={require(".././img/logging/logging-logfiles.png").default} alt="Logfiles overview" width="400"/>

:::note
These logs can help diagnose and fix any issues with your OpenCloud Desktop Client.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 8
sidebar_position: 2
id: multiple-accounts
title: Set up multiple accounts
description: Using multiple Accounts in OpenCloud Desktop
Expand All @@ -15,9 +15,9 @@ You can synchronize multiple accounts from different OpenCloud servers to your l
- Open OpenCloud Desktop
- Click on Add Account

<img src={require("./img/multiple-accounts/multiple-accounts-add-account.png").default} alt="Add accounts" width="400"/>
<img src={require(".././img/multiple-accounts/multiple-accounts-add-account.png").default} alt="Add accounts" width="400"/>

- Follow the [standard setup process](/docs/user/desktop-client/set-up):
- Follow the standard setup process:
- Enter the server URL
- Log in with your credentials
- Authorize access
Expand All @@ -27,7 +27,7 @@ You can synchronize multiple accounts from different OpenCloud servers to your l
- After adding multiple accounts, they will appear in the account overview in the settings menu
- You can easily switch between them to manage synchronization settings for each account separately

<img src={require("./img/multiple-accounts/multiple-accounts-switch-accounts.png").default} alt="Switch accounts" width="400"/>
<img src={require(".././img/multiple-accounts/multiple-accounts-switch-accounts.png").default} alt="Switch accounts" width="400"/>

## How Files are Stored Locally

Expand All @@ -37,7 +37,7 @@ You can synchronize multiple accounts from different OpenCloud servers to your l
- OpenCloud (2) (for the second account)
- OpenCloud (3) (for the third account), and so on

<img src={require("./img/multiple-accounts/multiple-accounts-locally.png").default} alt="Multiple accounts in explorer or finder" width="400"/>
<img src={require(".././img/multiple-accounts/multiple-accounts-locally.png").default} alt="Multiple accounts in explorer or finder" width="400"/>

:::note
This setup ensures that files from different accounts remain organized and do not mix.
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/desktop-client/img/vfs/full-pinned.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/desktop-client/img/vfs/full.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/user/desktop-client/img/vfs/placeholder.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
52 changes: 0 additions & 52 deletions docs/user/desktop-client/installation.md

This file was deleted.

9 changes: 9 additions & 0 deletions docs/user/desktop-client/linux/_category_.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
{
"label": "Desktop Client for Linux",
"position": 3,
"link": {
"type": "generated-index",
"description": "OpenCloud Desktop Client for Linux.",
"slug": "user/desktop/linux"
}
}
67 changes: 67 additions & 0 deletions docs/user/desktop-client/linux/installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
---
sidebar_position: 1
id: installation
title: Installation
description: Install OpenCloud Desktop Client on Linux
draft: false
---

# Installation on Linux (AppImage with AppImageLauncher)

The OpenCloud Desktop Client is available as an AppImage for Linux.
Using AppImageLauncher is recommended to ensure proper system integration, menu entries, and simplified updates.

## Install AppImageLauncher

AppImageLauncher integrates AppImages into your system and manages them like regular applications.

Follow the installation instructions here:

[AppImageLauncher Installation Guide](https://github.com/TheAssassin/AppImageLauncher/releases/tag/v3.0.0-beta-3)

## Download the OpenCloud AppImage

Download the latest or desired `.AppImage` version from the official release page:

- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases)

Save the file to your preferred download directory.

## Integrate the AppImage

Once AppImageLauncher is installed:

1. Right-click the downloaded `OpenCloud.AppImage`.
2. Select “Open with AppImageLauncher”.
3. Confirm integration when prompted.

AppImageLauncher will automatically:

- store the AppImage in the correct location
- register a menu entry
- ensure the app behaves like a native application

## Launching OpenCloud Desktop

After integration, you can start the client as usual through your application menu:

- open your Application Launcher
- search for OpenCloud Desktop
- start the application

The client will guide you through the initial setup.

## Updating the AppImage

When a new version is available, download the updated AppImage from GitHub.
AppImageLauncher will detect it and offer to replace the existing version automatically.

## Uninstallation

To remove the OpenCloud Desktop Client:

1. Open your application menu.
2. Search for OpenCloud Desktop
3. Select the option to remove or uninstall the AppImage (menu wording may vary depending on distribution and launcher).

AppImageLauncher will cleanly remove the integrated AppImage.
Original file line number Diff line number Diff line change
Expand Up @@ -16,27 +16,27 @@ Follow these simple steps to install and configure your OpenCloud Desktop and st
- Enter the URL of your OpenCloud instance
- Click "Continue"

<img src={require("./img/set-up/set-up-enter-url.png").default} alt="Enter URL" width="400"/>
<img src={require(".././img/set-up/set-up-enter-url.png").default} alt="Enter URL" width="400"/>

## Log In via Web Browser

- Click "Open web browser" to log in automatically
- Alternatively, copy the provided URL and paste it into your browser manually

<img src={require("./img/set-up/set-up-login.png").default} alt="Open browser to login" width="400"/>
<img src={require(".././img/set-up/set-up-login.png").default} alt="Open browser to login" width="400"/>

## Enter Your Credentials

- Enter your username and password
- Click "Login"

<img src={require("./img/set-up/set-up-user-password.png").default} alt="Enter credentials" width="400"/>
<img src={require(".././img/set-up/set-up-user-password.png").default} alt="Enter credentials" width="400"/>

## Grant Access

- Accept the access request to link your account with OpenCloud Desktop.

<img src={require("./img/set-up/set-up-accept-access.png").default} alt="Grand access" width="400"/>
<img src={require(".././img/set-up/set-up-accept-access.png").default} alt="Grand access" width="400"/>

## Finalize Setup

Expand All @@ -45,11 +45,11 @@ Follow these simple steps to install and configure your OpenCloud Desktop and st
- Choose whether to sync all files or select specific folders (this can be adjusted later).
- Change the local download directory where your files will be stored.

<img src={require("./img/set-up/set-up-advanced-configuration.png").default} alt="Finalize setup" width="400"/>
<img src={require(".././img/set-up/set-up-advanced-configuration.png").default} alt="Finalize setup" width="400"/>

Once you're ready, click Done to complete the setup.

<img src={require("./img/set-up/set-up-all-set.png").default} alt="All set" width="400"/>
<img src={require(".././img/set-up/set-up-all-set.png").default} alt="All set" width="400"/>

OpenCloud Desktop is now successfully set up.
You can start syncing your files seamlessly between your device and the OpenCloud server!
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
sidebar_position: 3
id: settings
title: Settings
description: Change settings in OpenCloud Desktop
title: Settings in Linux
description: Settings in OpenCloud Desktop for Linux
draft: false
---

Expand All @@ -14,7 +14,7 @@ You can customize OpenCloud Desktop settings by following these steps:

- Click on "Settings" in the top-right corner of OpenCloud Desktop

<img src={require("./img/settings/settings-overview.png").default} alt="Settings overview" width="400"/>
<img src={require(".././img/settings/settings-overview.png").default} alt="Settings overview" width="400"/>

## Overview of Settings Sections

Expand All @@ -24,7 +24,7 @@ You can customize OpenCloud Desktop settings by following these steps:
- Choose whether to show desktop notifications
- Set your preferred language

<img src={require("./img/settings/settings-general.png").default} alt="Settings-general" width="400"/>
<img src={require(".././img/settings/settings-general.png").default} alt="Settings-general" width="400"/>

### Advanced Settings

Expand All @@ -33,7 +33,7 @@ You can customize OpenCloud Desktop settings by following these steps:
- Edit the ignored files list
- Enable a debug log file for troubleshooting

<img src={require("./img/settings/settings-advanced.png").default} alt="Settings advanced" width="400"/>
<img src={require(".././img/settings/settings-advanced.png").default} alt="Settings advanced" width="400"/>

### Network Settings

Expand All @@ -42,7 +42,7 @@ You can customize OpenCloud Desktop settings by following these steps:
- Use system proxy (default)
- Manually enter a proxy

<img src={require("./img/settings/settings-network.png").default} alt="Settings network" width="400"/>
<img src={require(".././img/settings/settings-network.png").default} alt="Settings network" width="400"/>

### Download and Upload Bandwidth

Expand All @@ -51,8 +51,4 @@ You can customize OpenCloud Desktop settings by following these steps:
- Automatically adjust limit
- Set a specific limit manually

<img src={require("./img/settings/settings-bandwidth.png").default} alt="Settings bandwidth" width="400"/>

:::note
By adjusting these settings, you can optimize OpenCloud Desktop according to your needs!
:::
<img src={require(".././img/settings/settings-bandwidth.png").default} alt="Settings bandwidth" width="400"/>
Loading