From 5908b4c4dc132ced2ac62566c5ea023f57e4c3cc Mon Sep 17 00:00:00 2001
From: Viktor Scharf <scharf.vi@gmail.com>
Date: Fri, 7 Mar 2025 18:45:50 +0100
Subject: [PATCH 1/4] add upgrade guide

---
 .../20-getting-started/50-raspberry-pi.md     |   2 +-
 docs/admin/40-maintenance/10-update.md        |   6 --
 docs/admin/40-maintenance/10-upgrade.md       |  95 ++++++++++++++++++
 docs/admin/40-maintenance/img/init-diff.png   | Bin 0 -> 13502 bytes
 4 files changed, 96 insertions(+), 7 deletions(-)
 delete mode 100644 docs/admin/40-maintenance/10-update.md
 create mode 100644 docs/admin/40-maintenance/10-upgrade.md
 create mode 100644 docs/admin/40-maintenance/img/init-diff.png

diff --git a/docs/admin/20-getting-started/50-raspberry-pi.md b/docs/admin/20-getting-started/50-raspberry-pi.md
index cfe69cee..b2eeb94e 100644
--- a/docs/admin/20-getting-started/50-raspberry-pi.md
+++ b/docs/admin/20-getting-started/50-raspberry-pi.md
@@ -215,7 +215,7 @@ How to set up DDNS in the router:
 - Search for the DDNS settings - these are usually located under Network, Internet or Dynamic DNS.
 - Select No-IP as your provider from the list of supported DDNS services.
 - Enter your No-IP credentials (username & password).
-- Enter the hostname you previously created with No-IP (e.g. ocis-at-home.ddns.net).
+- Enter the hostname you previously created with No-IP (e.g. opencloud-at-home.ddns.net).
 - Save the settings and test the connection.
 
 The router will now automatically update your public IP address at No-IP so that your Raspberry Pi always remains accessible under the selected subdomain.
diff --git a/docs/admin/40-maintenance/10-update.md b/docs/admin/40-maintenance/10-update.md
deleted file mode 100644
index 1ca83816..00000000
--- a/docs/admin/40-maintenance/10-update.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-sidebar_position: 1
-id: update
-title: "Update"
-draft: true
----
\ No newline at end of file
diff --git a/docs/admin/40-maintenance/10-upgrade.md b/docs/admin/40-maintenance/10-upgrade.md
new file mode 100644
index 00000000..071a5d1d
--- /dev/null
+++ b/docs/admin/40-maintenance/10-upgrade.md
@@ -0,0 +1,95 @@
+---
+sidebar_position: 1
+id: update
+title: "Upgrade"
+description: "🔄 Keep your setup up to date with the latest features!"
+---
+
+import Tabs from '@theme/Tabs'
+import TabItem from '@theme/TabItem'
+
+This guide provides steps to upgrade OpenCloud for both [docker](docs/admin/20-getting-started/30-docker.md) and [docker compose](docs/admin/20-getting-started/20-docker-compose.md)
+
+### 1. Stop OpenCloud
+
+Stop the currently running OpenCloud instance:
+
+<Tabs groupId="deployment">
+  <TabItem value="docker" label="docker">
+    ```Shell
+    docker stop opencloud
+    ```
+  </TabItem>
+  <TabItem value="docker-compose" label="docker compose">
+    ```Shell
+    docker compose stop
+    ``` 
+  </TabItem>
+</Tabs>
+
+---
+
+### 2. Backup Config and Data
+
+It is recommended to create a backup before proceeding with the upgrade.
+
+TODO: put backup link #103.
+
+---
+
+### 3. Pull the new Opencloud version
+
+```Shell
+docker pull opencloudeu/opencloud:{tag}
+```
+
+---
+
+### 4. Verify Configuration Changes
+
+If upgrading from an older release, check for required configuration changes:
+
+Go to inside the container:
+```Shell
+docker run --rm -it --entrypoint /bin/sh -v $HOME/opencloud/opencloud-config:/etc/opencloud opencloudeu/opencloud:{tag}
+```
+
+```Shell
+opencloud init --diff
+```
+
+If you see `no changes, your config is up to date`, no further action is needed. Otherwise, update your `opencloud.yaml` file accordingly and start OpenCloud.
+
+<img src={require("./img/init-diff.png").default} alt="init -diff" width="1920"/>
+
+---
+
+### 5. Start OpenCloud with updated image
+
+<Tabs groupId="deployment">
+  <TabItem value="docker" label="docker">
+    ```Shell
+    docker run \
+    --name opencloud \
+    --rm \
+    -it \
+    -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:{tag}
+    ```
+  </TabItem>
+  <TabItem value="docker-compose" label="docker compose">
+    ```Shell
+    OC_DOCKER_IMAGE=opencloudeu/opencloud OC_DOCKER_TAG=tag docker compose up -d
+    ```
+  </TabItem>
+</Tabs>
+
+---
+
+### 6. Conclusion
+Make sure that all previously created data, users, shared files, public links exist.
diff --git a/docs/admin/40-maintenance/img/init-diff.png b/docs/admin/40-maintenance/img/init-diff.png
new file mode 100644
index 0000000000000000000000000000000000000000..94b6f0a058bf2b95d72bb4b2856d3269aa16507e
GIT binary patch
literal 13502
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

literal 0
HcmV?d00001


From 20e4e46ddcb7bbf96a321e887039b41ce603b111 Mon Sep 17 00:00:00 2001
From: OpenCloud Devops <devops@opencloud.eu>
Date: Mon, 10 Mar 2025 15:44:11 +0100
Subject: [PATCH 2/4] =?UTF-8?q?=F0=9F=8E=89=20Release=201.3.0=20(#152)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7d9ea032..bd1ca59d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.3.0](https://github.com/opencloud-eu/docs/releases/tag/1.3.0) - 2025-03-10
+
+### ❤️ Thanks to all contributors! ❤️
+
+@Heiko-Pohl, @ScharfViktor, @kulmann
+
+### 👷 Admin Documentation
+
+- add upgrade guide [[#154](https://github.com/opencloud-eu/docs/pull/154)]
+- Backup Tutorial [[#148](https://github.com/opencloud-eu/docs/pull/148)]
+- delete screenshot in bare metal documentation [[#149](https://github.com/opencloud-eu/docs/pull/149)]
+
+### 🐛 Bug Fixes
+
+- Fix typo on index.md [[#153](https://github.com/opencloud-eu/docs/pull/153)]
+
 ## [1.2.0](https://github.com/opencloud-eu/docs/releases/tag/1.2.0) - 2025-03-07
 
 ### ❤️ Thanks to all contributors! ❤️

From 763e8e860089fef94970616fc462976054395f75 Mon Sep 17 00:00:00 2001
From: Klaas Freitag <k.freitag@opencloud.eu>
Date: Thu, 13 Mar 2025 17:21:26 +0100
Subject: [PATCH 3/4] Admin information for the new posix storage driver

---
 .../30-configuration/80-storage-posix.md      | 65 ++++++++++++++++++-
 1 file changed, 64 insertions(+), 1 deletion(-)

diff --git a/docs/admin/30-configuration/80-storage-posix.md b/docs/admin/30-configuration/80-storage-posix.md
index 9ccb1c9c..2b623eb9 100644
--- a/docs/admin/30-configuration/80-storage-posix.md
+++ b/docs/admin/30-configuration/80-storage-posix.md
@@ -3,4 +3,67 @@ sidebar_position: 8
 id: storage-posix
 title: "Storage: Posix"
 draft: true
----
\ No newline at end of file
+---
+
+# PosixFS Storage Driver
+
+PosixFS is a storage driver that saves OpenClouds files and folders in a folder structure how the user sees that in the web interface or other clients. That is a difference compared to DecomposedFS, which stores files in a technical folder structure that has limited meaning for admins.
+
+There are two modes to destinguish:
+
+1. *non collaborative mode* where the filesystem tree in use is exclusively granted to OpenCloud
+2. *collaborative mode* where modifications of the underlying file tree are permitted by other processes than OpenCloud
+
+The *collaborative mode* is not yet available and follow later.
+
+## Metadata
+
+To allow OpenCloud to work database less, extra metadata is stored in the extended file attributes of each file. To mitigate size limitations for extended file attributes of file systems, metadata is moved to an extra metadata file if overall size exceeds a certain limit. In that case, only a reference to the meta data file is kept in the extended file attributes.
+
+## Access Model
+
+PosixFS in *non collaborative mode* must not be changed manually in the file system while OpenCloud is up and running. The assigned file system tree has to be exclusive granted for OpenClouds access.
+
+File- and folder permissions must be set to the same user and group that OpenCloud is running under. That is happening autmatically as long as the root directory of the tree is writeable.
+
+### External Access
+
+When OpenCloud is shut down, limited manipulation of the underlying file system tree is possible for certain administration tasks such as
+
+- adding files and folders
+- removing files and folders
+- renaming files and folders
+
+:::warning
+
+Whenever files are manipulated externally of OpenCloud, it is important to remember to
+
+- shut down OpenCloud before starting
+- do not loose the extended file attributes of individual files
+- set the file- and folder permissions correctly
+
+:::
+
+## Backup
+
+With PosixFS backup and restore is easy. The entire OpenCloud filesystem tree can be snapshotted regularly and restored as needed. It depends on the filesystem type how that has to be done in detail.
+
+## Migration
+
+PosixFS in this so called *non collaborative mode* is the default for new installations of OpenCloud. There is currently no way to migrate OpenCloud installations with DecomposedFS backend to PosixFS.
+
+If that is needed, data needs to be copied into a new installation of OpenCloud with PosixFS.
+
+# Configuration
+
+T collaborative PosixFS storage driver is part of the default OpenCloud bundle.
+
+Involved configuration settings (environment variables) to enable PosixFS are:
+
+- `STORAGE_USERS_DRIVER` needs to be set to `posix`
+- `STORAGE_USERS_ID_CACHE_STORE` needs to be set to `nats-js-kv`
+- `STORAGE_USERS_POSIX_ROOT` can be omitted for default, or set the storage root directory
+
+---
+
+

From cb6a8e098f6c698e74e38ebbfc069d2cb6aa9f18 Mon Sep 17 00:00:00 2001
From: Klaas Freitag <kraft@freisturz.de>
Date: Fri, 14 Mar 2025 09:41:55 +0100
Subject: [PATCH 4/4] Spelling and wording fixes

Co-authored-by: Phil Davis <phil@jankaritech.com>
---
 docs/admin/30-configuration/80-storage-posix.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/admin/30-configuration/80-storage-posix.md b/docs/admin/30-configuration/80-storage-posix.md
index 2b623eb9..2abf868b 100644
--- a/docs/admin/30-configuration/80-storage-posix.md
+++ b/docs/admin/30-configuration/80-storage-posix.md
@@ -9,20 +9,20 @@ draft: true
 
 PosixFS is a storage driver that saves OpenClouds files and folders in a folder structure how the user sees that in the web interface or other clients. That is a difference compared to DecomposedFS, which stores files in a technical folder structure that has limited meaning for admins.
 
-There are two modes to destinguish:
+There are two modes to distinguish:
 
 1. *non collaborative mode* where the filesystem tree in use is exclusively granted to OpenCloud
 2. *collaborative mode* where modifications of the underlying file tree are permitted by other processes than OpenCloud
 
-The *collaborative mode* is not yet available and follow later.
+The *collaborative mode* is not yet available and will follow later.
 
 ## Metadata
 
-To allow OpenCloud to work database less, extra metadata is stored in the extended file attributes of each file. To mitigate size limitations for extended file attributes of file systems, metadata is moved to an extra metadata file if overall size exceeds a certain limit. In that case, only a reference to the meta data file is kept in the extended file attributes.
+To allow OpenCloud to work database-less, extra metadata is stored in the extended file attributes of each file. To mitigate size limitations for extended file attributes of file systems, metadata is moved to an extra metadata file if overall size exceeds a certain limit. In that case, only a reference to the meta data file is kept in the extended file attributes.
 
 ## Access Model
 
-PosixFS in *non collaborative mode* must not be changed manually in the file system while OpenCloud is up and running. The assigned file system tree has to be exclusive granted for OpenClouds access.
+PosixFS in *non collaborative mode* must not be changed manually in the file system while OpenCloud is up and running. The assigned file system tree has to be exclusively granted for OpenClouds access.
 
 File- and folder permissions must be set to the same user and group that OpenCloud is running under. That is happening autmatically as long as the root directory of the tree is writeable.
 
@@ -36,10 +36,10 @@ When OpenCloud is shut down, limited manipulation of the underlying file system
 
 :::warning
 
-Whenever files are manipulated externally of OpenCloud, it is important to remember to
+Whenever files are manipulated externally to OpenCloud, it is important to remember to
 
 - shut down OpenCloud before starting
-- do not loose the extended file attributes of individual files
+- do not lose the extended file attributes of individual files
 - set the file- and folder permissions correctly
 
 :::
@@ -56,7 +56,7 @@ If that is needed, data needs to be copied into a new installation of OpenCloud
 
 # Configuration
 
-T collaborative PosixFS storage driver is part of the default OpenCloud bundle.
+The collaborative PosixFS storage driver is part of the default OpenCloud bundle.
 
 Involved configuration settings (environment variables) to enable PosixFS are: