Add start with decomposeds3 storage guide

docs/admin/installation/common-issues.md → docs/admin/common-issues.md

@@ -13,7 +13,7 @@ title: Common Issues & Help
 docker ps
 ```
 
-<img src={require("./img/quick-guide/quick-docker-running.png").default} alt="Admin general" width="1920"/>
+<img src={require("./img/common-issues/quick-docker-running.png").default} alt="Admin general" width="1920"/>
 
 Several containers should be listed here, e.g., for opencloud, traefik, etc.
 <br/><br/>
@@ -28,8 +28,9 @@ For Firefox:
 
 You need to klick on **Advanced**
 
-<img src={require("./img/quick-guide/quick-advanced.png").default} alt="Admin general" width="500"/>
+<img src={require("./img/common-issues/quick-advanced.png").default} alt="Admin general" width="500"/>
 
 Confirm the risk with **Accept the risk and Contiune**
 
-<img src={require("./img/quick-guide/quick-accept-security-risk.png").default} alt="Admin general" width="500"/>
+<img src={require("./img/common-issues/quick-accept-security-risk.png").default} alt="Admin general" width="500"/>
+

docs/admin/installation/bare-metal.md

@@ -106,4 +106,4 @@ Your OpenCloud server is now running and ready to use 🚀
 ---
 
 ### If you encounter any issues or errors, try finding a solution here: 
-- [Common Issues & Help](./common-issues.md)
+- [Common Issues & Help](./../common-issues.md)

docs/admin/installation/docker-compose.md

@@ -39,7 +39,7 @@ cd into the Docker Compose configuration folder:
 cd opencloud/deployments/examples/opencloud_full
 ```
 
-Start the depoyment with Docker Compose:
+Start the deployment with Docker Compose:
 
 ```Shell
 docker compose up -d
@@ -54,11 +54,12 @@ This starts all necessary containers in the background.
 
 ### 3. Add local domains to /etc/hosts 
 
+Edit the /etc/hosts file and add the following entries for local access:
+
 ```
 127.0.0.1       cloud.opencloud.test
 127.0.0.1       collabora.opencloud.test
 127.0.0.1       wopiserver.opencloud.test
-127.0.0.1       mail.opencloud.test
 127.0.0.1       onlyoffice.opencloud.test
 ```
 <br/><br/>
@@ -81,5 +82,8 @@ Your OpenCloud server is now running and ready to use 🚀
 
 --- 
 
-### If you encounter any issues or errors, try finding a solution here: 
-- [Common Issues & Help](./common-issues.md)
+### Troubleshooting
+
+If you encounter any issues or errors, try finding a solution here: 
+
+- [Common Issues & Help](./../common-issues.md)

docs/admin/installation/docker.md

@@ -93,5 +93,8 @@ Your OpenCloud server is now running and ready to use 🚀
 
 --- 
 
-### If you encounter any issues or errors, try finding a solution here: 
-- [Common Issues & Help](./common-issues.md)
+### Troubleshooting
+
+If you encounter any issues or errors, try finding a solution here: 
+
+- [Common Issues & Help](./../common-issues.md)

docs/admin/storage/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Storage Integration",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "description": "OpenCloud Storage Integration."
+  }
+}

docs/admin/storage/decomposeds3.md

@@ -0,0 +1,80 @@
+---
+sidebar_position: 1
+id: decomposeds3
+title: Decomposeds3
+---
+
+# Decomposeds3 Storage Driver
+
+Decomposeds3 is a storage driver for OpenCloud that uses MinIO, an S3-compatible object storage, for handling file storage efficiently. This setup leverages S3’s scalability while integrating seamlessly with OpenCloud.
+
+---
+
+**Prerequisites:**
+- **Linux**, **Mac** or **Windows** Subsystem for Linux [(WSL)](https://learn.microsoft.com/en-us/windows/wsl/install)
+- [**Docker**](https://docs.docker.com/compose/install/)
+- [**Docker Compose**](https://docs.docker.com/compose/install/)
+
+---
+
+##  1. Download
+
+Download the `opencloud_full` folder (this folder contains a multi-file Docker Compose configuration):
+
+```Shell
+git clone https://github.com/opencloud-eu/opencloud.git
+```
+
+## 2. Start
+
+Navigate to the Docker Compose configuration folder:
+
+```Shell
+cd opencloud/deployments/examples/opencloud_full
+```
+
+Enable `decomposeds3.yml` and `minio.yml` in the `.env` file:
+
+```Shell
+nano opencloud/deployments/examples/opencloud_full/.env
+```
+
+Find all required environment variables `env` here: [decomposeds3-envs](https://github.com/opencloud-eu/opencloud/blob/main/services/storage-users/pkg/config/config.go#L143-L176)
+
+Start the deployment with Docker Compose:
+
+```Shell
+docker compose up -d
+```
+
+This starts all necessary containers in the background.
+
+## 3. Add local domains to /etc/hosts 
+
+Edit the /etc/hosts file and add the following entries for local access:
+
+```
+127.0.0.1       cloud.opencloud.test
+127.0.0.1       minio.opencloud.test
+```
+
+## 4. Login
+
+Login with your browser:
+- [https://cloud.opencloud.test](https://cloud.opencloud.test)
+- user: **admin**
+- password: **admin**
+
+🎉 Congratulations! You’ve successfully set up and launched OpenCloud! Happy hacking!🚀
+
+<img src={require("./img/login-page.png").default} alt="Admin general" width="1920"/>
+
+<img src={require("./img/decomposeds3-with-minio.png").default} alt="Admin general" width="1920"/>
+
+--- 
+
+### Troubleshooting
+
+If you encounter any issues or errors, try finding a solution here: 
+
+- [Common Issues & Help](./../common-issues.md)