From 1481e9c93b75e8ede88f1a6094d6138833637cc6 Mon Sep 17 00:00:00 2001
From: Heiko Pohl <h.pohl@opencloud.eu>
Date: Thu, 21 May 2026 10:25:33 +0200
Subject: [PATCH 1/4] Upgrade process from 4.0.x to 7.0.x

---
 .../maintenance/upgrade/upgrade-7.0.x.md      | 328 ++++++++++++++++++
 1 file changed, 328 insertions(+)
 create mode 100644 docs/admin/maintenance/upgrade/upgrade-7.0.x.md

diff --git a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
new file mode 100644
index 00000000..4aedbc60
--- /dev/null
+++ b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
@@ -0,0 +1,328 @@
+---
+sidebar_position: 4
+id: upgrade-7.0.x
+title: Upgrade 7.0.x
+description: Upgrading to 7.0.x
+draft: false
+---
+
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+# Upgrading to OpenCloud 7.0.x
+
+This guide explains how to upgrade an existing OpenCloud deployment to the 7.0.x release.
+It includes all required migration steps, configuration changes, and search index updates introduced in this release.
+
+The upgrade applies to deployments using:
+
+- Docker Compose
+- Docker Named Volumes
+- Bind Mounts
+
+Following this guide ensures a safe migration to OpenCloud 7.0.x.
+
+## Before starting the upgrade:
+
+- Create a complete backup of your configuration and data.
+- Ensure you have access to your current opencloud.yaml.
+- Verify that your current deployment is healthy before upgrading.
+
+
+## Backup Config and Data
+
+:::important 
+Always create a backup before upgrading to prevent data loss.
+:::
+
+- Using Bind Mounts
+```bash
+cp -a /mnt/opencloud/config /mnt/opencloud/config-backup
+cp -a /mnt/opencloud/data /mnt/opencloud/data-backup
+```
+- Using Docker Named Volumes
+- Create Backup Directory
+```bash
+mkdir -p ~/opencloud-backups
+```
+- Backup Config and Data
+```bash
+docker cp opencloud_full-opencloud-1:/var/lib/opencloud ~/opencloud-backups/data-backup
+docker cp opencloud_full-opencloud-1:/etc/opencloud ~/opencloud-backups/config-backup
+```
+- Stop OpenCloud
+    - Docker
+    ```bash
+    docker stop opencloud
+    ```
+    - Docker Compose
+    ```bash
+    docker compose stop
+    ```
+    - Pull the New Release Image
+    ```bash
+    docker pull opencloudeu/opencloud:7.0.x
+    ```
+
+## Configuration Migration Breaking Change
+
+OpenCloud 7.0.x introduces a breaking configuration change.
+
+Reference: [Migration PR](https://github.com/opencloud-eu/opencloud/pull/2760)
+
+- Verify Configuration Changes
+
+- Go inside the opencloud container.
+
+- Using Bind Mounts
+
+- Replace **your-home-directory** with your actual directory.
+```bash
+docker run --rm -it --entrypoint /bin/sh \
+  -v "your-home-directory"/opencloud/opencloud-config:/etc/opencloud \
+  opencloudeu/opencloud:7.0.x
+```
+
+- Using Docker Named Volumes
+
+- Replace **your-named-volume** with your actual volume name.
+```bash
+docker run --rm -it --entrypoint /bin/sh \
+  -v "your-named-volume":/etc/opencloud \
+  opencloudeu/opencloud:7.0.x
+```
+- Generate the Configuration Diff
+
+    - Inside the container run:
+
+    ```bash
+    opencloud init --diff
+    ```
+
+    - Example output:
+    ```bash
+    diff -u /etc/opencloud/opencloud.yaml /etc/opencloud/opencloud.yaml.tmp
+    ```
+
+    - A patch file will automatically be created:
+    ```bash
+    /etc/opencloud/opencloud.config.patch
+    ```
+
+- Apply the Configuration Patch
+
+    - Go to the configuration directory:
+
+    ```bash cd /etc/opencloud
+    ```
+
+    - Verify the generated files:
+
+    Example:
+
+    ```bash
+    ls
+    banned-password-list.txt
+    csp.yaml
+    opencloud.config.patch
+    opencloud.yaml
+    opencloud.yaml.2026-05-19-15-45-44.backup
+    ```
+
+- Apply the patch:
+
+```bash
+patch < opencloud.config.patch
+```
+
+    - Expected output:
+
+    ```bash
+    patching file opencloud.yaml
+    Required Configuration Changes
+    ```
+
+## The following configuration entries must exist in opencloud.yaml:
+
+```bash
+service_account:
+service_account_id: 62b789c9-0dd0-4647-afd3-d6969eab03b8
+service_account_secret: wAiwglE93^S-y3hm0bo5FS9sFj^rzQ&i
+```
+
+## Verify that these values were added successfully after applying the patch.
+
+- Start OpenCloud 7.0.x
+```bash
+docker run \
+    --name opencloud \
+    --rm \
+    -d \
+    -p 9200:9200 \
+    -v $HOME/opencloud/opencloud-config:/etc/opencloud \
+    -v $HOME/opencloud/opencloud-data:/var/lib/opencloud \
+    -e OC_INSECURE=true \
+    -e PROXY_HTTP_ADDR=0.0.0.0:9200 \
+    -e OC_URL=https://localhost:9200 \
+    opencloudeu/opencloud:7.0.x
+Docker Compose
+```
+
+# If you previously used the project name opencloud_full, continue using the same project name to preserve:
+
+```bash
+Docker networks
+Existing volumes
+Service compatibility
+Option 1 — Temporary
+docker compose -p opencloud_full up -d
+Option 2 — Permanent
+```
+
+- Add to .env:
+
+```bash
+COMPOSE_PROJECT_NAME=opencloud_full
+```
+
+- Then start normally:
+
+```bash
+docker compose up -d
+Verify the Migration
+```
+
+- After startup, monitor the logs:
+
+```bash
+docker logs -f opencloud
+```
+or:
+```bash
+docker compose logs -f
+```
+
+## Watch for migration messages and ensure no errors occur.
+
+- Verify Project Spaces
+
+- After the migration completes:
+
+    - Open all existing project spaces
+    - Verify that all members still exist
+    - Check permissions and shared access
+
+
+## Reindex OpenSearch Breaking Change
+
+This step is important because the migration changes internal member handling.
+OpenCloud 7.0.x introduces a new OpenSearch index structure.  
+Reference: [OpenSearch Index PR](https://github.com/opencloud-eu/opencloud/pull/2514)
+
+Rebuild the search index after upgrading:
+
+- ```bash
+    opencloud search index --all-spaces
+  ```
+
+Depending on the size of your installation, this process may take some time.
+
+
+## Web Breaking Changes
+
+OpenCloud Web also includes breaking changes in this release.
+
+Review the official OpenCloud 7.0.x release notes carefully:
+
+- Verification  
+Your OpenCloud instance should now be running on 7.0.x.
+
+    - Essential Checks
+    - User Accounts — Verify all users can log in
+    - Shared Folders — Confirm shares remain functional
+    - Public Links — Test public links
+    - Search — Verify search works correctly after reindexing
+    - Project Spaces — Check members and permissions
+    - Service Health — Review logs for warnings or errors
+    - Troubleshooting
+
+- If issues occur during or after the upgrade:
+
+    - Review container logs
+    - Verify opencloud.yaml
+    - Re-run the configuration diff if necessary
+    - Restore from backup if required
+    - Consult the troubleshooting documentation
+    - Open an issue on GitHub if needed
+
+- Useful resources:
+
+    - OpenCloud Troubleshooting Guide
+    - OpenCloud GitHub Issues
+
+
+## Updating Web Extensions for OpenCloud 7.0.x
+
+OpenCloud 7.0.x introduces breaking changes in the web client architecture.
+Because of these changes, older web extension versions are no longer compatible and must be updated.
+
+:::
+Important: Existing web extensions from older OpenCloud releases will not work with 7.0.x.
+All installed extensions must be upgraded to the latest compatible version.
+:::
+
+- New extension versions are available in the App Store inside the OpenCloud UI
+or on [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
+
+
+- Update via OpenCloud App Store
+    - Sign in as an administrator.
+    - Open: Settings → Apps
+    - Check all installed extensions.
+    - Update or reinstall each extension to the latest version.
+
+- After updating, reload the browser and verify that the extensions work correctly.
+
+- Manual Update
+    - Download the newest extension release from: [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
+
+- Upload the Extension
+
+    - Example using scp:
+
+    ```bash
+    scp extension-name.zip root@your-server:/opt/opencloud/extensions/
+    ```
+
+- Install the Extension
+
+- Connect to the server:
+    ```bash
+    ssh root@your-server
+    ```
+
+- Go to the extensions directory:
+    ```bash
+    cd /opt/opencloud/extensions
+    ```
+
+- Extract the archive:
+    ```bash
+    unzip extension-name.zip
+    ```
+- Restart Docker Compose
+    ```bash
+    docker compose restart
+    ```
+- Verification
+    - After restarting:
+        - reload the browser
+        - verify all extensions load correctly
+        - check functionality
+        - review logs if issues occur
+        - Example:  
+        ```bash
+        docker compose logs -f
+        ```
+
+Older extension versions are not compatible with OpenCloud 7.0.x.
\ No newline at end of file

From d4693c8c708696f0063b0f5b3ac8c0e8503e344c Mon Sep 17 00:00:00 2001
From: Heiko Pohl <h.pohl@opencloud.eu>
Date: Thu, 21 May 2026 11:08:19 +0200
Subject: [PATCH 2/4] add minimum version

---
 .../maintenance/upgrade/upgrade-7.0.x.md      | 241 ++++++++++--------
 1 file changed, 129 insertions(+), 112 deletions(-)

diff --git a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
index 4aedbc60..afd3d8e0 100644
--- a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
+++ b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
@@ -22,47 +22,58 @@ The upgrade applies to deployments using:
 
 Following this guide ensures a safe migration to OpenCloud 7.0.x.
 
-## Before starting the upgrade:
+## Before starting the upgrade
 
+- Ensure you have OpenCloud 4.0.7 installed
 - Create a complete backup of your configuration and data.
 - Ensure you have access to your current opencloud.yaml.
 - Verify that your current deployment is healthy before upgrading.
 
-
 ## Backup Config and Data
 
-:::important 
+:::important
 Always create a backup before upgrading to prevent data loss.
 :::
 
 - Using Bind Mounts
+
 ```bash
 cp -a /mnt/opencloud/config /mnt/opencloud/config-backup
 cp -a /mnt/opencloud/data /mnt/opencloud/data-backup
 ```
+
 - Using Docker Named Volumes
 - Create Backup Directory
+
 ```bash
 mkdir -p ~/opencloud-backups
 ```
+
 - Backup Config and Data
+
 ```bash
 docker cp opencloud_full-opencloud-1:/var/lib/opencloud ~/opencloud-backups/data-backup
 docker cp opencloud_full-opencloud-1:/etc/opencloud ~/opencloud-backups/config-backup
 ```
+
 - Stop OpenCloud
-    - Docker
-    ```bash
-    docker stop opencloud
-    ```
-    - Docker Compose
-    ```bash
-    docker compose stop
-    ```
-    - Pull the New Release Image
-    ```bash
-    docker pull opencloudeu/opencloud:7.0.x
-    ```
+  - Docker
+
+  ```bash
+  docker stop opencloud
+  ```
+
+  - Docker Compose
+
+  ```bash
+  docker compose stop
+  ```
+
+  - Pull the New Release Image
+
+  ```bash
+  docker pull opencloudeu/opencloud:7.0.x
+  ```
 
 ## Configuration Migration Breaking Change
 
@@ -77,6 +88,7 @@ Reference: [Migration PR](https://github.com/opencloud-eu/opencloud/pull/2760)
 - Using Bind Mounts
 
 - Replace **your-home-directory** with your actual directory.
+
 ```bash
 docker run --rm -it --entrypoint /bin/sh \
   -v "your-home-directory"/opencloud/opencloud-config:/etc/opencloud \
@@ -86,48 +98,51 @@ docker run --rm -it --entrypoint /bin/sh \
 - Using Docker Named Volumes
 
 - Replace **your-named-volume** with your actual volume name.
+
 ```bash
 docker run --rm -it --entrypoint /bin/sh \
   -v "your-named-volume":/etc/opencloud \
   opencloudeu/opencloud:7.0.x
 ```
+
 - Generate the Configuration Diff
+  - Inside the container run:
 
-    - Inside the container run:
+  ```bash
+  opencloud init --diff
+  ```
 
-    ```bash
-    opencloud init --diff
-    ```
+  - Example output:
 
-    - Example output:
-    ```bash
-    diff -u /etc/opencloud/opencloud.yaml /etc/opencloud/opencloud.yaml.tmp
-    ```
+  ```bash
+  diff -u /etc/opencloud/opencloud.yaml /etc/opencloud/opencloud.yaml.tmp
+  ```
 
-    - A patch file will automatically be created:
-    ```bash
-    /etc/opencloud/opencloud.config.patch
-    ```
+  - A patch file will automatically be created:
+
+  ```bash
+  /etc/opencloud/opencloud.config.patch
+  ```
 
 - Apply the Configuration Patch
+  - Go to the configuration directory:
 
-    - Go to the configuration directory:
+  ```bash cd /etc/opencloud
 
-    ```bash cd /etc/opencloud
-    ```
+  ```
 
-    - Verify the generated files:
+  - Verify the generated files:
 
-    Example:
+  Example:
 
-    ```bash
-    ls
-    banned-password-list.txt
-    csp.yaml
-    opencloud.config.patch
-    opencloud.yaml
-    opencloud.yaml.2026-05-19-15-45-44.backup
-    ```
+  ```bash
+  ls
+  banned-password-list.txt
+  csp.yaml
+  opencloud.config.patch
+  opencloud.yaml
+  opencloud.yaml.2026-05-19-15-45-44.backup
+  ```
 
 - Apply the patch:
 
@@ -135,14 +150,14 @@ docker run --rm -it --entrypoint /bin/sh \
 patch < opencloud.config.patch
 ```
 
-    - Expected output:
+- Expected output:
 
-    ```bash
-    patching file opencloud.yaml
-    Required Configuration Changes
-    ```
+```bash
+patching file opencloud.yaml
+Required Configuration Changes
+```
 
-## The following configuration entries must exist in opencloud.yaml:
+## The following configuration entries must exist in opencloud.yaml
 
 ```bash
 service_account:
@@ -150,9 +165,10 @@ service_account_id: 62b789c9-0dd0-4647-afd3-d6969eab03b8
 service_account_secret: wAiwglE93^S-y3hm0bo5FS9sFj^rzQ&i
 ```
 
-## Verify that these values were added successfully after applying the patch.
+## Verify that these values were added successfully after applying the patch
 
 - Start OpenCloud 7.0.x
+
 ```bash
 docker run \
     --name opencloud \
@@ -168,7 +184,7 @@ docker run \
 Docker Compose
 ```
 
-# If you previously used the project name opencloud_full, continue using the same project name to preserve:
+# If you previously used the project name opencloud_full, continue using the same project name to preserve
 
 ```bash
 Docker networks
@@ -197,21 +213,21 @@ Verify the Migration
 ```bash
 docker logs -f opencloud
 ```
+
 or:
+
 ```bash
 docker compose logs -f
 ```
 
-## Watch for migration messages and ensure no errors occur.
+## Watch for migration messages and ensure no errors occur
 
 - Verify Project Spaces
 
 - After the migration completes:
-
-    - Open all existing project spaces
-    - Verify that all members still exist
-    - Check permissions and shared access
-
+  - Open all existing project spaces
+  - Verify that all members still exist
+  - Check permissions and shared access
 
 ## Reindex OpenSearch Breaking Change
 
@@ -221,13 +237,12 @@ Reference: [OpenSearch Index PR](https://github.com/opencloud-eu/opencloud/pull/
 
 Rebuild the search index after upgrading:
 
-- ```bash
-    opencloud search index --all-spaces
-  ```
+```bash
+opencloud search index --all-spaces
+```
 
 Depending on the size of your installation, this process may take some time.
 
-
 ## Web Breaking Changes
 
 OpenCloud Web also includes breaking changes in this release.
@@ -235,31 +250,28 @@ OpenCloud Web also includes breaking changes in this release.
 Review the official OpenCloud 7.0.x release notes carefully:
 
 - Verification  
-Your OpenCloud instance should now be running on 7.0.x.
+  Your OpenCloud instance should now be running on 7.0.x.
 
-    - Essential Checks
-    - User Accounts — Verify all users can log in
-    - Shared Folders — Confirm shares remain functional
-    - Public Links — Test public links
-    - Search — Verify search works correctly after reindexing
-    - Project Spaces — Check members and permissions
-    - Service Health — Review logs for warnings or errors
-    - Troubleshooting
+  - Essential Checks
+  - User Accounts — Verify all users can log in
+  - Shared Folders — Confirm shares remain functional
+  - Public Links — Test public links
+  - Search — Verify search works correctly after reindexing
+  - Project Spaces — Check members and permissions
+  - Service Health — Review logs for warnings or errors
+  - Troubleshooting
 
 - If issues occur during or after the upgrade:
-
-    - Review container logs
-    - Verify opencloud.yaml
-    - Re-run the configuration diff if necessary
-    - Restore from backup if required
-    - Consult the troubleshooting documentation
-    - Open an issue on GitHub if needed
+  - Review container logs
+  - Verify opencloud.yaml
+  - Re-run the configuration diff if necessary
+  - Restore from backup if required
+  - Consult the troubleshooting documentation
+  - Open an issue on GitHub if needed
 
 - Useful resources:
-
-    - OpenCloud Troubleshooting Guide
-    - OpenCloud GitHub Issues
-
+  - OpenCloud Troubleshooting Guide
+  - OpenCloud GitHub Issues
 
 ## Updating Web Extensions for OpenCloud 7.0.x
 
@@ -272,57 +284,62 @@ All installed extensions must be upgraded to the latest compatible version.
 :::
 
 - New extension versions are available in the App Store inside the OpenCloud UI
-or on [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
-
+  or on [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
 
 - Update via OpenCloud App Store
-    - Sign in as an administrator.
-    - Open: Settings → Apps
-    - Check all installed extensions.
-    - Update or reinstall each extension to the latest version.
+  - Sign in as an administrator.
+  - Open: Settings → Apps
+  - Check all installed extensions.
+  - Update or reinstall each extension to the latest version.
 
 - After updating, reload the browser and verify that the extensions work correctly.
 
 - Manual Update
-    - Download the newest extension release from: [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
+  - Download the newest extension release from: [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
 
 - Upload the Extension
+  - Example using scp:
 
-    - Example using scp:
-
-    ```bash
-    scp extension-name.zip root@your-server:/opt/opencloud/extensions/
-    ```
+  ```bash
+  scp extension-name.zip root@your-server:/opt/opencloud/extensions/
+  ```
 
 - Install the Extension
 
 - Connect to the server:
-    ```bash
-    ssh root@your-server
-    ```
+
+  ```bash
+  ssh root@your-server
+  ```
 
 - Go to the extensions directory:
-    ```bash
-    cd /opt/opencloud/extensions
-    ```
+
+  ```bash
+  cd /opt/opencloud/extensions
+  ```
 
 - Extract the archive:
-    ```bash
-    unzip extension-name.zip
-    ```
+
+  ```bash
+  unzip extension-name.zip
+  ```
+
 - Restart Docker Compose
+
+  ```bash
+  docker compose restart
+  ```
+
+- Verification
+  - After restarting:
+    - reload the browser
+    - verify all extensions load correctly
+    - check functionality
+    - review logs if issues occur
+    - Example:
+
     ```bash
-    docker compose restart
+    docker compose logs -f
     ```
-- Verification
-    - After restarting:
-        - reload the browser
-        - verify all extensions load correctly
-        - check functionality
-        - review logs if issues occur
-        - Example:  
-        ```bash
-        docker compose logs -f
-        ```
-
-Older extension versions are not compatible with OpenCloud 7.0.x.
\ No newline at end of file
+
+Older extension versions are not compatible with OpenCloud 7.0.x.

From ce7558cb3ec286d344f44fff1f225917259f75df Mon Sep 17 00:00:00 2001
From: Jannik Stehle <j.stehle@opencloud.eu>
Date: Tue, 26 May 2026 08:18:56 +0200
Subject: [PATCH 3/4] docs: improve web extensions section in 7.0.x migration
 guide

---
 .../maintenance/upgrade/upgrade-7.0.x.md      | 69 +------------------
 1 file changed, 2 insertions(+), 67 deletions(-)

diff --git a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
index afd3d8e0..efd2cb82 100644
--- a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
+++ b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
@@ -251,7 +251,6 @@ Review the official OpenCloud 7.0.x release notes carefully:
 
 - Verification  
   Your OpenCloud instance should now be running on 7.0.x.
-
   - Essential Checks
   - User Accounts — Verify all users can log in
   - Shared Folders — Confirm shares remain functional
@@ -276,70 +275,6 @@ Review the official OpenCloud 7.0.x release notes carefully:
 ## Updating Web Extensions for OpenCloud 7.0.x
 
 OpenCloud 7.0.x introduces breaking changes in the web client architecture.
-Because of these changes, older web extension versions are no longer compatible and must be updated.
-
-:::
-Important: Existing web extensions from older OpenCloud releases will not work with 7.0.x.
-All installed extensions must be upgraded to the latest compatible version.
-:::
-
-- New extension versions are available in the App Store inside the OpenCloud UI
-  or on [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
-
-- Update via OpenCloud App Store
-  - Sign in as an administrator.
-  - Open: Settings → Apps
-  - Check all installed extensions.
-  - Update or reinstall each extension to the latest version.
-
-- After updating, reload the browser and verify that the extensions work correctly.
-
-- Manual Update
-  - Download the newest extension release from: [GitHub](https://github.com/opencloud-eu/web-extensions/releases?utm_source=chatgpt.com)
-
-- Upload the Extension
-  - Example using scp:
-
-  ```bash
-  scp extension-name.zip root@your-server:/opt/opencloud/extensions/
-  ```
-
-- Install the Extension
-
-- Connect to the server:
-
-  ```bash
-  ssh root@your-server
-  ```
-
-- Go to the extensions directory:
-
-  ```bash
-  cd /opt/opencloud/extensions
-  ```
-
-- Extract the archive:
-
-  ```bash
-  unzip extension-name.zip
-  ```
-
-- Restart Docker Compose
-
-  ```bash
-  docker compose restart
-  ```
-
-- Verification
-  - After restarting:
-    - reload the browser
-    - verify all extensions load correctly
-    - check functionality
-    - review logs if issues occur
-    - Example:
-
-    ```bash
-    docker compose logs -f
-    ```
+Because of these changes, older web extension versions are no longer compatible with OpenCloud 7.0.x and must be updated.
 
-Older extension versions are not compatible with OpenCloud 7.0.x.
+New extension versions are available in the App Store inside the OpenCloud UI or on [GitHub](https://github.com/opencloud-eu/web-extensions/releases). To update your extensions, download their latest version and follow the [app installation guide](../../configuration/web-applications.md).

From 630bace246d3622c7a99b35a0f199423e03960dc Mon Sep 17 00:00:00 2001
From: Heiko Pohl <h.pohl@opencloud.eu>
Date: Tue, 26 May 2026 16:02:28 +0200
Subject: [PATCH 4/4] refine Upgrading to OpenCloud 7.0.x Tutorial

---
 .../maintenance/upgrade/upgrade-7.0.x.md      | 138 ++++++------------
 1 file changed, 42 insertions(+), 96 deletions(-)

diff --git a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
index efd2cb82..fcda89d1 100644
--- a/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
+++ b/docs/admin/maintenance/upgrade/upgrade-7.0.x.md
@@ -90,9 +90,7 @@ Reference: [Migration PR](https://github.com/opencloud-eu/opencloud/pull/2760)
 - Replace **your-home-directory** with your actual directory.
 
 ```bash
-docker run --rm -it --entrypoint /bin/sh \
-  -v "your-home-directory"/opencloud/opencloud-config:/etc/opencloud \
-  opencloudeu/opencloud:7.0.x
+docker run --rm -it --entrypoint /bin/sh -v "your-home-directory-path":/etc/opencloud opencloudeu/opencloud:7.0.x
 ```
 
 - Using Docker Named Volumes
@@ -100,9 +98,7 @@ docker run --rm -it --entrypoint /bin/sh \
 - Replace **your-named-volume** with your actual volume name.
 
 ```bash
-docker run --rm -it --entrypoint /bin/sh \
-  -v "your-named-volume":/etc/opencloud \
-  opencloudeu/opencloud:7.0.x
+docker run --rm -it --entrypoint /bin/sh -v "your-named-volume-path":/etc/opencloud opencloudeu/opencloud:7.0.x
 ```
 
 - Generate the Configuration Diff
@@ -116,13 +112,28 @@ docker run --rm -it --entrypoint /bin/sh \
 
   ```bash
   diff -u /etc/opencloud/opencloud.yaml /etc/opencloud/opencloud.yaml.tmp
+  --- /etc/opencloud/opencloud.yaml
+  +++ /etc/opencloud/opencloud.yaml.tmp
+  @@ -90,6 +90,9 @@
+  sharing:
+   events:
+     tls_insecure: false
   ```
 
-  - A patch file will automatically be created:
+- service_account:
+- service_account_id: 05bca760-ff47-44e3-9532-de8568e097bc
+- service_account_secret: NavT+c9okb.AD+170x3..!W78EVXJtSM
+  storage_users:
+  events:
+  tls_insecure: false
 
-  ```bash
-  /etc/opencloud/opencloud.config.patch
-  ```
+diff written to /etc/opencloud/opencloud.config.patch
+
+- A patch file will automatically be created:
+
+```bash
+/etc/opencloud/opencloud.config.patch
+```
 
 - Apply the Configuration Patch
   - Go to the configuration directory:
@@ -144,18 +155,31 @@ docker run --rm -it --entrypoint /bin/sh \
   opencloud.yaml.2026-05-19-15-45-44.backup
   ```
 
+- Testing the patch:
+  - Run the following command:
+
+  ```bash
+  patch --dry-run opencloud.yaml < opencloud.config.patch
+  ```
+
+  - Expecting output:
+
+  ```bash
+  checking file opencloud.yaml
+  ```
+
 - Apply the patch:
+  - Run the following command:
 
-```bash
-patch < opencloud.config.patch
-```
+  ```bash
+  patch opencloud.yaml < opencloud.config.patch
+  ```
 
-- Expected output:
+  - Expected output:
 
-```bash
-patching file opencloud.yaml
-Required Configuration Changes
-```
+  ```bash
+  patching file opencloud.yaml
+  ```
 
 ## The following configuration entries must exist in opencloud.yaml
 
@@ -165,84 +189,6 @@ service_account_id: 62b789c9-0dd0-4647-afd3-d6969eab03b8
 service_account_secret: wAiwglE93^S-y3hm0bo5FS9sFj^rzQ&i
 ```
 
-## Verify that these values were added successfully after applying the patch
-
-- Start OpenCloud 7.0.x
-
-```bash
-docker run \
-    --name opencloud \
-    --rm \
-    -d \
-    -p 9200:9200 \
-    -v $HOME/opencloud/opencloud-config:/etc/opencloud \
-    -v $HOME/opencloud/opencloud-data:/var/lib/opencloud \
-    -e OC_INSECURE=true \
-    -e PROXY_HTTP_ADDR=0.0.0.0:9200 \
-    -e OC_URL=https://localhost:9200 \
-    opencloudeu/opencloud:7.0.x
-Docker Compose
-```
-
-# If you previously used the project name opencloud_full, continue using the same project name to preserve
-
-```bash
-Docker networks
-Existing volumes
-Service compatibility
-Option 1 — Temporary
-docker compose -p opencloud_full up -d
-Option 2 — Permanent
-```
-
-- Add to .env:
-
-```bash
-COMPOSE_PROJECT_NAME=opencloud_full
-```
-
-- Then start normally:
-
-```bash
-docker compose up -d
-Verify the Migration
-```
-
-- After startup, monitor the logs:
-
-```bash
-docker logs -f opencloud
-```
-
-or:
-
-```bash
-docker compose logs -f
-```
-
-## Watch for migration messages and ensure no errors occur
-
-- Verify Project Spaces
-
-- After the migration completes:
-  - Open all existing project spaces
-  - Verify that all members still exist
-  - Check permissions and shared access
-
-## Reindex OpenSearch Breaking Change
-
-This step is important because the migration changes internal member handling.
-OpenCloud 7.0.x introduces a new OpenSearch index structure.  
-Reference: [OpenSearch Index PR](https://github.com/opencloud-eu/opencloud/pull/2514)
-
-Rebuild the search index after upgrading:
-
-```bash
-opencloud search index --all-spaces
-```
-
-Depending on the size of your installation, this process may take some time.
-
 ## Web Breaking Changes
 
 OpenCloud Web also includes breaking changes in this release.