From cb60e361e22cedf991941a35765fd8574be709f1 Mon Sep 17 00:00:00 2001 From: Heiko Pohl Date: Wed, 20 May 2026 12:05:58 +0200 Subject: [PATCH 1/2] update desktopclient for macos and linux --- docs/user/desktop-client/linux/upgrade.md | 119 ++++++++++++++++++ docs/user/desktop-client/macos/upgrade.md | 71 +++++++++++ .../user/desktop-client/linux/upgrade.md | 119 ++++++++++++++++++ .../user/desktop-client/macos/upgrade.md | 71 +++++++++++ 4 files changed, 380 insertions(+) create mode 100644 docs/user/desktop-client/linux/upgrade.md create mode 100644 docs/user/desktop-client/macos/upgrade.md create mode 100644 versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md create mode 100644 versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md diff --git a/docs/user/desktop-client/linux/upgrade.md b/docs/user/desktop-client/linux/upgrade.md new file mode 100644 index 00000000..3e3a4354 --- /dev/null +++ b/docs/user/desktop-client/linux/upgrade.md @@ -0,0 +1,119 @@ +--- +sidebar_position: 5 +id: upgrade-linux +title: Upgrade Desktop Client on Linux +description: Upgrade Desktop Client on Linux +draft: false +--- + +# Upgrade on Linux + +The OpenCloud Desktop Client on Linux can be upgraded using the package format or package manager originally used for installation. +Existing synchronization settings, accounts, and preferences are preserved during the upgrade process. + +## Upgrade on Debian / Ubuntu (.deb package) + +Download the latest .deb package from the official release page: + +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) +- Choose the package matching your system architecture. +- Save the file to your Downloads folder. +- Close OpenCloud Desktop + +## Before upgrading + +- Open the OpenCloud Desktop menu. +- Stop active synchronization if necessary. +- Quit the application completely. +- Install the Updated Package + +## Install the Upgrade + +- Open a terminal and navigate to your Downloads directory: + +```bash +cd ~/Downloads +``` + +- Install the updated package: + +```bash +sudo dpkg -i opencloud-desktop_version.deb +``` + +- If dependency issues occur, repair them using: + +```bash +sudo apt -f install +``` + +The existing installation will be updated automatically. + +- Launch the Updated Application + +- After installation, start OpenCloud Desktop from: + - the application menu + GNOME/KDE launcher + - or from a terminal: + opencloud + +Your existing configuration and synchronization settings remain available. + +## Verify the Installed Version + +- To check the installed version: + +```bash +opencloud --version +``` + +- You can also verify the version from within the graphical application: + - Help → About OpenCloud Desktop + +## If OpenCloud Desktop was installed from a configured repository, upgrade it using the package manager + +- Update Package Information + +```bash +sudo apt update +``` + +- Upgrade OpenCloud Desktop + +```bash +sudo apt upgrade +``` + +- Or upgrade only the desktop client: + +```bash +sudo apt install --only-upgrade opencloud-desktop +``` + +## Upgrade on Fedora / RHEL (.rpm package) + +- Download the newest .rpm package from: + +[OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) + +- Save the package locally. + +- Install the Updated Package + +```bash +sudo dnf install opencloud-desktop_version.rpm +``` + +The package manager upgrades the existing installation automatically. + +## Verify the Installation + +```bash +opencloud --version +``` + +:::note +User accounts and synchronization settings are preserved during upgrades. +Existing synchronized files are not modified or removed. +Restarting the system is typically not required after upgrading. +::: diff --git a/docs/user/desktop-client/macos/upgrade.md b/docs/user/desktop-client/macos/upgrade.md new file mode 100644 index 00000000..0765cb26 --- /dev/null +++ b/docs/user/desktop-client/macos/upgrade.md @@ -0,0 +1,71 @@ +--- +sidebar_position: 4 +id: upgrade-macos +title: Upgrade Desktop Client on macOS +description: Upgrade Desktop Client on macOS +draft: false +--- + +# Upgrade on macOS (.pkg file) + +The OpenCloud Desktop Client for macOS can be upgraded using the official signed .pkg installer. +This process safely replaces the existing application while preserving your account settings and synchronization configuration. + +## Download the Latest Installer + +Download the newest .pkg installer from the official release page: + +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) + +Choose the correct version for your Mac: + +- Apple Silicon Macs (M1, M2, M3): arm64 +- Intel Macs: x86_64 + +## Save the installer to your Downloads folder + +## Close OpenCloud Desktop + +## Before starting the upgrade + +- Click the OpenCloud Desktop icon in the macOS menu bar. +- Open the menu. +- Select Quit OpenCloud Desktop. + +This ensures that all synchronization processes are stopped cleanly before the update. + +## Run the Installer + +- Double-click the downloaded .pkg file. +- The macOS installer will launch automatically. +- Follow the on-screen instructions. +- When prompted, confirm that the existing installation should be replaced. + +The installer updates the application inside the system’s Applications directory. + +Existing accounts, synchronization folders, preferences,cached and credentials are preserved automatically. + +## Launch the Updated Application + +After the installation completes, launch OpenCloud Desktop from: + +- the Applications folder +- Launchpad +- or Spotlight (Cmd + Space) + +The client should start normally using your existing configuration. + +## Verify the Installed Version + +To confirm the upgrade: + +- Open OpenCloud Desktop. +- In the menu bar, select: +- OpenCloud Desktop → About OpenCloud Desktop + +The currently installed version number will be displayed. + +:::note +Upgrading does not remove synchronized files. +Existing user accounts and sync connections remain configured. +A system restart is usually not required after upgrading.::: diff --git a/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md b/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md new file mode 100644 index 00000000..3e3a4354 --- /dev/null +++ b/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md @@ -0,0 +1,119 @@ +--- +sidebar_position: 5 +id: upgrade-linux +title: Upgrade Desktop Client on Linux +description: Upgrade Desktop Client on Linux +draft: false +--- + +# Upgrade on Linux + +The OpenCloud Desktop Client on Linux can be upgraded using the package format or package manager originally used for installation. +Existing synchronization settings, accounts, and preferences are preserved during the upgrade process. + +## Upgrade on Debian / Ubuntu (.deb package) + +Download the latest .deb package from the official release page: + +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) +- Choose the package matching your system architecture. +- Save the file to your Downloads folder. +- Close OpenCloud Desktop + +## Before upgrading + +- Open the OpenCloud Desktop menu. +- Stop active synchronization if necessary. +- Quit the application completely. +- Install the Updated Package + +## Install the Upgrade + +- Open a terminal and navigate to your Downloads directory: + +```bash +cd ~/Downloads +``` + +- Install the updated package: + +```bash +sudo dpkg -i opencloud-desktop_version.deb +``` + +- If dependency issues occur, repair them using: + +```bash +sudo apt -f install +``` + +The existing installation will be updated automatically. + +- Launch the Updated Application + +- After installation, start OpenCloud Desktop from: + - the application menu + GNOME/KDE launcher + - or from a terminal: + opencloud + +Your existing configuration and synchronization settings remain available. + +## Verify the Installed Version + +- To check the installed version: + +```bash +opencloud --version +``` + +- You can also verify the version from within the graphical application: + - Help → About OpenCloud Desktop + +## If OpenCloud Desktop was installed from a configured repository, upgrade it using the package manager + +- Update Package Information + +```bash +sudo apt update +``` + +- Upgrade OpenCloud Desktop + +```bash +sudo apt upgrade +``` + +- Or upgrade only the desktop client: + +```bash +sudo apt install --only-upgrade opencloud-desktop +``` + +## Upgrade on Fedora / RHEL (.rpm package) + +- Download the newest .rpm package from: + +[OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) + +- Save the package locally. + +- Install the Updated Package + +```bash +sudo dnf install opencloud-desktop_version.rpm +``` + +The package manager upgrades the existing installation automatically. + +## Verify the Installation + +```bash +opencloud --version +``` + +:::note +User accounts and synchronization settings are preserved during upgrades. +Existing synchronized files are not modified or removed. +Restarting the system is typically not required after upgrading. +::: diff --git a/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md b/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md new file mode 100644 index 00000000..0765cb26 --- /dev/null +++ b/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md @@ -0,0 +1,71 @@ +--- +sidebar_position: 4 +id: upgrade-macos +title: Upgrade Desktop Client on macOS +description: Upgrade Desktop Client on macOS +draft: false +--- + +# Upgrade on macOS (.pkg file) + +The OpenCloud Desktop Client for macOS can be upgraded using the official signed .pkg installer. +This process safely replaces the existing application while preserving your account settings and synchronization configuration. + +## Download the Latest Installer + +Download the newest .pkg installer from the official release page: + +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) + +Choose the correct version for your Mac: + +- Apple Silicon Macs (M1, M2, M3): arm64 +- Intel Macs: x86_64 + +## Save the installer to your Downloads folder + +## Close OpenCloud Desktop + +## Before starting the upgrade + +- Click the OpenCloud Desktop icon in the macOS menu bar. +- Open the menu. +- Select Quit OpenCloud Desktop. + +This ensures that all synchronization processes are stopped cleanly before the update. + +## Run the Installer + +- Double-click the downloaded .pkg file. +- The macOS installer will launch automatically. +- Follow the on-screen instructions. +- When prompted, confirm that the existing installation should be replaced. + +The installer updates the application inside the system’s Applications directory. + +Existing accounts, synchronization folders, preferences,cached and credentials are preserved automatically. + +## Launch the Updated Application + +After the installation completes, launch OpenCloud Desktop from: + +- the Applications folder +- Launchpad +- or Spotlight (Cmd + Space) + +The client should start normally using your existing configuration. + +## Verify the Installed Version + +To confirm the upgrade: + +- Open OpenCloud Desktop. +- In the menu bar, select: +- OpenCloud Desktop → About OpenCloud Desktop + +The currently installed version number will be displayed. + +:::note +Upgrading does not remove synchronized files. +Existing user accounts and sync connections remain configured. +A system restart is usually not required after upgrading.::: From 93d53ca492c8c9e8d5fe2a6e06080eaeff621bd5 Mon Sep 17 00:00:00 2001 From: Anja Barz Date: Wed, 20 May 2026 16:40:47 +0200 Subject: [PATCH 2/2] Improve the macOS upgrade guide for better readability and align the Linux upgrade guide with the AppImage installation flow. --- docs/user/desktop-client/linux/upgrade.md | 121 ++++++------------ docs/user/desktop-client/macos/upgrade.md | 63 ++++----- .../user/desktop-client/linux/upgrade.md | 121 ++++++------------ .../user/desktop-client/macos/upgrade.md | 63 ++++----- 4 files changed, 142 insertions(+), 226 deletions(-) diff --git a/docs/user/desktop-client/linux/upgrade.md b/docs/user/desktop-client/linux/upgrade.md index 3e3a4354..3b422eb5 100644 --- a/docs/user/desktop-client/linux/upgrade.md +++ b/docs/user/desktop-client/linux/upgrade.md @@ -6,114 +6,67 @@ description: Upgrade Desktop Client on Linux draft: false --- -# Upgrade on Linux +# Upgrade Desktop Client on Linux -The OpenCloud Desktop Client on Linux can be upgraded using the package format or package manager originally used for installation. -Existing synchronization settings, accounts, and preferences are preserved during the upgrade process. +The OpenCloud Desktop Client for Linux is provided as an AppImage. -## Upgrade on Debian / Ubuntu (.deb package) +If you installed OpenCloud Desktop with AppImageLauncher, the client can be upgraded by downloading the updated AppImage and replacing the existing integrated version. -Download the latest .deb package from the official release page: +Existing accounts, synchronization settings, preferences, cached data, and credentials are preserved during the upgrade. -- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -- Choose the package matching your system architecture. -- Save the file to your Downloads folder. -- Close OpenCloud Desktop - -## Before upgrading - -- Open the OpenCloud Desktop menu. -- Stop active synchronization if necessary. -- Quit the application completely. -- Install the Updated Package - -## Install the Upgrade - -- Open a terminal and navigate to your Downloads directory: - -```bash -cd ~/Downloads -``` - -- Install the updated package: - -```bash -sudo dpkg -i opencloud-desktop_version.deb -``` - -- If dependency issues occur, repair them using: +## Download the Latest AppImage -```bash -sudo apt -f install -``` +Download the latest `.AppImage` file from the official release page: -The existing installation will be updated automatically. - -- Launch the Updated Application - -- After installation, start OpenCloud Desktop from: - - the application menu - GNOME/KDE launcher - - or from a terminal: - opencloud - -Your existing configuration and synchronization settings remain available. - -## Verify the Installed Version +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -- To check the installed version: +Choose the AppImage that matches your system architecture and save it to your Downloads folder or another location where you can easily find it. -```bash -opencloud --version -``` +## Close OpenCloud Desktop -- You can also verify the version from within the graphical application: - - Help → About OpenCloud Desktop +Before starting the upgrade, close the running Desktop Client: -## If OpenCloud Desktop was installed from a configured repository, upgrade it using the package manager +1. Open the OpenCloud Desktop menu. +2. Stop active synchronization if necessary. +3. Select Quit OpenCloud Desktop. -- Update Package Information +This ensures that all synchronization processes are stopped cleanly before the upgrade. -```bash -sudo apt update -``` +## Replace the Existing AppImage -- Upgrade OpenCloud Desktop +To upgrade OpenCloud Desktop with AppImageLauncher: -```bash -sudo apt upgrade -``` +1. Right-click the downloaded `.AppImage` file. +2. Select Open with AppImageLauncher. +3. Confirm that the existing integrated version should be replaced when prompted. -- Or upgrade only the desktop client: +AppImageLauncher replaces the existing AppImage and keeps the application menu entry available. -```bash -sudo apt install --only-upgrade opencloud-desktop -``` +## Launch the Updated Application -## Upgrade on Fedora / RHEL (.rpm package) +After the upgrade has completed, start OpenCloud Desktop from your application menu: -- Download the newest .rpm package from: +1. Open your application launcher. +2. Search for OpenCloud Desktop. +3. Start the application. -[OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) +The client should start normally and use your existing configuration. -- Save the package locally. +## Verify the Installed Version -- Install the Updated Package +To confirm that the upgrade was successful: -```bash -sudo dnf install opencloud-desktop_version.rpm -``` +1. Open OpenCloud Desktop. +2. Open the settings. +3. Select About. +4. Check the displayed version number. -The package manager upgrades the existing installation automatically. +The currently installed version number is displayed in the about dialog. -## Verify the Installation +:::note +Upgrading does not remove synchronized files. -```bash -opencloud --version -``` +Existing user accounts and sync connections remain configured. -:::note -User accounts and synchronization settings are preserved during upgrades. -Existing synchronized files are not modified or removed. -Restarting the system is typically not required after upgrading. +A system restart is usually not required after upgrading. ::: diff --git a/docs/user/desktop-client/macos/upgrade.md b/docs/user/desktop-client/macos/upgrade.md index 0765cb26..ab2b833c 100644 --- a/docs/user/desktop-client/macos/upgrade.md +++ b/docs/user/desktop-client/macos/upgrade.md @@ -6,66 +6,71 @@ description: Upgrade Desktop Client on macOS draft: false --- -# Upgrade on macOS (.pkg file) +# Upgrade Desktop Client on macOS -The OpenCloud Desktop Client for macOS can be upgraded using the official signed .pkg installer. -This process safely replaces the existing application while preserving your account settings and synchronization configuration. +The OpenCloud Desktop Client for macOS can be upgraded using the official signed `.pkg` installer. + +The upgrade replaces the existing application while preserving your account settings, synchronization configuration, preferences, cached data, and credentials. ## Download the Latest Installer -Download the newest .pkg installer from the official release page: +Download the latest `.pkg` installer from the official release page: - [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -Choose the correct version for your Mac: +Choose the installer that matches your Mac architecture: -- Apple Silicon Macs (M1, M2, M3): arm64 -- Intel Macs: x86_64 +- Apple Silicon Macs (M1, M2, M3): `arm64` +- Intel Macs: `x86_64` -## Save the installer to your Downloads folder +Save the installer to your Downloads folder or another location where you can easily find it. ## Close OpenCloud Desktop -## Before starting the upgrade +Before starting the upgrade, close the running Desktop Client: -- Click the OpenCloud Desktop icon in the macOS menu bar. -- Open the menu. -- Select Quit OpenCloud Desktop. +1. Click the OpenCloud Desktop icon in the macOS menu bar. +2. Open the menu. +3. Select Quit OpenCloud Desktop. -This ensures that all synchronization processes are stopped cleanly before the update. +This ensures that all synchronization processes are stopped cleanly before the upgrade. ## Run the Installer -- Double-click the downloaded .pkg file. -- The macOS installer will launch automatically. -- Follow the on-screen instructions. -- When prompted, confirm that the existing installation should be replaced. +To upgrade OpenCloud Desktop: + +1. Double-click the downloaded `.pkg` file. +2. Follow the instructions in the macOS installer. +3. When prompted, confirm that the existing installation should be replaced. -The installer updates the application inside the system’s Applications directory. +The installer updates the application in the Applications folder. -Existing accounts, synchronization folders, preferences,cached and credentials are preserved automatically. +Existing accounts, synchronization folders, preferences, cached data, and credentials are preserved automatically. ## Launch the Updated Application -After the installation completes, launch OpenCloud Desktop from: +After the installation has completed, launch OpenCloud Desktop from one of the following locations: -- the Applications folder +- Applications folder - Launchpad -- or Spotlight (Cmd + Space) +- Spotlight -The client should start normally using your existing configuration. +The client should start normally and use your existing configuration. ## Verify the Installed Version -To confirm the upgrade: +To confirm that the upgrade was successful: -- Open OpenCloud Desktop. -- In the menu bar, select: -- OpenCloud Desktop → About OpenCloud Desktop +1. Open OpenCloud Desktop. +2. Open the settings. +3. Select About and check the version. -The currently installed version number will be displayed. +The currently installed version number is displayed in the about dialog. :::note Upgrading does not remove synchronized files. + Existing user accounts and sync connections remain configured. -A system restart is usually not required after upgrading.::: + +A system restart is usually not required after upgrading. +::: diff --git a/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md b/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md index 3e3a4354..3b422eb5 100644 --- a/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md +++ b/versioned_docs/version-4.0/user/desktop-client/linux/upgrade.md @@ -6,114 +6,67 @@ description: Upgrade Desktop Client on Linux draft: false --- -# Upgrade on Linux +# Upgrade Desktop Client on Linux -The OpenCloud Desktop Client on Linux can be upgraded using the package format or package manager originally used for installation. -Existing synchronization settings, accounts, and preferences are preserved during the upgrade process. +The OpenCloud Desktop Client for Linux is provided as an AppImage. -## Upgrade on Debian / Ubuntu (.deb package) +If you installed OpenCloud Desktop with AppImageLauncher, the client can be upgraded by downloading the updated AppImage and replacing the existing integrated version. -Download the latest .deb package from the official release page: +Existing accounts, synchronization settings, preferences, cached data, and credentials are preserved during the upgrade. -- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -- Choose the package matching your system architecture. -- Save the file to your Downloads folder. -- Close OpenCloud Desktop - -## Before upgrading - -- Open the OpenCloud Desktop menu. -- Stop active synchronization if necessary. -- Quit the application completely. -- Install the Updated Package - -## Install the Upgrade - -- Open a terminal and navigate to your Downloads directory: - -```bash -cd ~/Downloads -``` - -- Install the updated package: - -```bash -sudo dpkg -i opencloud-desktop_version.deb -``` - -- If dependency issues occur, repair them using: +## Download the Latest AppImage -```bash -sudo apt -f install -``` +Download the latest `.AppImage` file from the official release page: -The existing installation will be updated automatically. - -- Launch the Updated Application - -- After installation, start OpenCloud Desktop from: - - the application menu - GNOME/KDE launcher - - or from a terminal: - opencloud - -Your existing configuration and synchronization settings remain available. - -## Verify the Installed Version +- [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -- To check the installed version: +Choose the AppImage that matches your system architecture and save it to your Downloads folder or another location where you can easily find it. -```bash -opencloud --version -``` +## Close OpenCloud Desktop -- You can also verify the version from within the graphical application: - - Help → About OpenCloud Desktop +Before starting the upgrade, close the running Desktop Client: -## If OpenCloud Desktop was installed from a configured repository, upgrade it using the package manager +1. Open the OpenCloud Desktop menu. +2. Stop active synchronization if necessary. +3. Select Quit OpenCloud Desktop. -- Update Package Information +This ensures that all synchronization processes are stopped cleanly before the upgrade. -```bash -sudo apt update -``` +## Replace the Existing AppImage -- Upgrade OpenCloud Desktop +To upgrade OpenCloud Desktop with AppImageLauncher: -```bash -sudo apt upgrade -``` +1. Right-click the downloaded `.AppImage` file. +2. Select Open with AppImageLauncher. +3. Confirm that the existing integrated version should be replaced when prompted. -- Or upgrade only the desktop client: +AppImageLauncher replaces the existing AppImage and keeps the application menu entry available. -```bash -sudo apt install --only-upgrade opencloud-desktop -``` +## Launch the Updated Application -## Upgrade on Fedora / RHEL (.rpm package) +After the upgrade has completed, start OpenCloud Desktop from your application menu: -- Download the newest .rpm package from: +1. Open your application launcher. +2. Search for OpenCloud Desktop. +3. Start the application. -[OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) +The client should start normally and use your existing configuration. -- Save the package locally. +## Verify the Installed Version -- Install the Updated Package +To confirm that the upgrade was successful: -```bash -sudo dnf install opencloud-desktop_version.rpm -``` +1. Open OpenCloud Desktop. +2. Open the settings. +3. Select About. +4. Check the displayed version number. -The package manager upgrades the existing installation automatically. +The currently installed version number is displayed in the about dialog. -## Verify the Installation +:::note +Upgrading does not remove synchronized files. -```bash -opencloud --version -``` +Existing user accounts and sync connections remain configured. -:::note -User accounts and synchronization settings are preserved during upgrades. -Existing synchronized files are not modified or removed. -Restarting the system is typically not required after upgrading. +A system restart is usually not required after upgrading. ::: diff --git a/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md b/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md index 0765cb26..ab2b833c 100644 --- a/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md +++ b/versioned_docs/version-4.0/user/desktop-client/macos/upgrade.md @@ -6,66 +6,71 @@ description: Upgrade Desktop Client on macOS draft: false --- -# Upgrade on macOS (.pkg file) +# Upgrade Desktop Client on macOS -The OpenCloud Desktop Client for macOS can be upgraded using the official signed .pkg installer. -This process safely replaces the existing application while preserving your account settings and synchronization configuration. +The OpenCloud Desktop Client for macOS can be upgraded using the official signed `.pkg` installer. + +The upgrade replaces the existing application while preserving your account settings, synchronization configuration, preferences, cached data, and credentials. ## Download the Latest Installer -Download the newest .pkg installer from the official release page: +Download the latest `.pkg` installer from the official release page: - [OpenCloud Desktop Releases on GitHub](https://github.com/opencloud-eu/desktop/releases) -Choose the correct version for your Mac: +Choose the installer that matches your Mac architecture: -- Apple Silicon Macs (M1, M2, M3): arm64 -- Intel Macs: x86_64 +- Apple Silicon Macs (M1, M2, M3): `arm64` +- Intel Macs: `x86_64` -## Save the installer to your Downloads folder +Save the installer to your Downloads folder or another location where you can easily find it. ## Close OpenCloud Desktop -## Before starting the upgrade +Before starting the upgrade, close the running Desktop Client: -- Click the OpenCloud Desktop icon in the macOS menu bar. -- Open the menu. -- Select Quit OpenCloud Desktop. +1. Click the OpenCloud Desktop icon in the macOS menu bar. +2. Open the menu. +3. Select Quit OpenCloud Desktop. -This ensures that all synchronization processes are stopped cleanly before the update. +This ensures that all synchronization processes are stopped cleanly before the upgrade. ## Run the Installer -- Double-click the downloaded .pkg file. -- The macOS installer will launch automatically. -- Follow the on-screen instructions. -- When prompted, confirm that the existing installation should be replaced. +To upgrade OpenCloud Desktop: + +1. Double-click the downloaded `.pkg` file. +2. Follow the instructions in the macOS installer. +3. When prompted, confirm that the existing installation should be replaced. -The installer updates the application inside the system’s Applications directory. +The installer updates the application in the Applications folder. -Existing accounts, synchronization folders, preferences,cached and credentials are preserved automatically. +Existing accounts, synchronization folders, preferences, cached data, and credentials are preserved automatically. ## Launch the Updated Application -After the installation completes, launch OpenCloud Desktop from: +After the installation has completed, launch OpenCloud Desktop from one of the following locations: -- the Applications folder +- Applications folder - Launchpad -- or Spotlight (Cmd + Space) +- Spotlight -The client should start normally using your existing configuration. +The client should start normally and use your existing configuration. ## Verify the Installed Version -To confirm the upgrade: +To confirm that the upgrade was successful: -- Open OpenCloud Desktop. -- In the menu bar, select: -- OpenCloud Desktop → About OpenCloud Desktop +1. Open OpenCloud Desktop. +2. Open the settings. +3. Select About and check the version. -The currently installed version number will be displayed. +The currently installed version number is displayed in the about dialog. :::note Upgrading does not remove synchronized files. + Existing user accounts and sync connections remain configured. -A system restart is usually not required after upgrading.::: + +A system restart is usually not required after upgrading. +:::