restructure the common issues in the admin part

docs/_static/env-vars/idm_readme.md

@@ -19,11 +19,10 @@ rm ldap.crt ldap.key
 docker compose restart
 ```
 
-The certificate and key are automatically regenerated when the container starts again. For more details, see [Internal LibreIDM cert expires](https://docs.opencloud.eu/docs/admin/resources/common-issues/#internal-libreidm-cert-expires).
+The certificate and key are automatically regenerated when the container starts again. For more details, see [Internal LibreIDM certificate expires](../../admin/resources/common-issues/libreidm-cert-expiry.md).
 
 Note: IDM is limited in its functionality. It only supports a subset of the LDAP operations (namely `BIND`, `SEARCH`, `ADD`, `MODIFY`, `DELETE`). Also, IDM currently does not do any schema verification (like. structural vs. auxiliary object classes, require and option attributes, syntax checks, …). Therefore it is not meant as a general purpose LDAP server.
 
 ## Table of Contents
 
 
-

docs/admin/configuration/storage/decomposeds3.md

@@ -87,4 +87,4 @@ After logging in, you should see the OpenCloud interface:
 
 If you run into any issues or errors, check the following resource:
 
-- [Common Issues & Help](../../resources/common-issues)
+- [Common Issues & Help](../../resources/common-issues/index.md)

docs/admin/getting-started/container/docker-compose/docker-compose-base.md

@@ -283,4 +283,4 @@ If you encounter issues:
 1. Check Docker logs: `docker compose logs`
 2. Verify domain DNS records point to your server
 3. Ensure firewall allows HTTP (80) and HTTPS (443)
-4. See [Common Issues & Help](../../../resources/common-issues.md)
+4. See [Common Issues & Help](../../../resources/common-issues/index.md)

docs/admin/getting-started/container/docker.md

@@ -76,4 +76,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](../../resources/common-issues)
+- [Common Issues & Help](../../resources/common-issues/index.md)

docs/admin/getting-started/other/bare-metal.md

@@ -128,4 +128,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](../../resources/common-issues)
+- [Common Issues & Help](../../resources/common-issues/index.md)

docs/admin/maintenance/maintenance-commands.md

@@ -237,7 +237,7 @@ docker compose stop opencloud
 sudo docker run -it --rm -v <opencloud-data-path>:/var/lib/opencloud -v <opencloud-config-path>:/etc/opencloud opencloudeu/opencloud:<opencloud-version> idm resetpassword
 ```
 
-See [Common Issues](../resources/common-issues.md) for the full walkthrough, including how to find the volume names.
+See [Admin password cannot be changed in `.env`](../resources/common-issues/admin-password-reset.md) for the full walkthrough, including how to find the volume names.
 
 ### Create an app token
 

docs/admin/maintenance/upgrade/upgrade-4.0.0.md

@@ -237,6 +237,6 @@ Your OpenCloud instance should now be running on `v4.0.x`.
 If you encounter issues during or after the upgrade:
 
 1. Review the logs for error messages
-2. Consult the [troubleshooting guide](../../resources/common-issues)
+2. Consult the [troubleshooting guide](../../resources/common-issues/index.md)
 3. Restore from backup if necessary
 4. Contact support or open an issue on [GitHub](https://github.com/opencloud-eu/opencloud/issues)

docs/admin/maintenance/upgrade/upgrade-7.x.x.md

@@ -374,6 +374,6 @@ If issues occur during or after the upgrade:
 
 ## Useful Resources
 
-- [OpenCloud Troubleshooting Guide](../../resources/common-issues.md)
+- [OpenCloud Troubleshooting Guide](../../resources/common-issues/index.md)
 - [OpenCloud GitHub Issues](https://github.com/opencloud-eu/opencloud/issues)
 - [OpenCloud Web Extensions Releases](https://github.com/opencloud-eu/web-extensions/releases)

docs/admin/resources/common-issues/_category_.json

@@ -0,0 +1,8 @@
+{
+  "label": "Common Issues & Help",
+  "position": 4,
+  "link": {
+    "type": "doc",
+    "id": "common-issues-overview"
+  }
+}

docs/admin/resources/common-issues/admin-password-reset.md

@@ -0,0 +1,79 @@
+---
+sidebar_position: 5
+id: admin-password-reset
+title: Admin password cannot be changed in `.env`
+description: Change or reset the OpenCloud admin password
+draft: false
+hide_table_of_contents: true
+---
+
+# Admin password cannot be changed in `.env`
+
+## Problem
+
+Changing the OpenCloud admin password in the `.env` file has no effect after the container has been initialized, or the current password has been forgotten.
+
+## Cause
+
+The `.env` value is used to set the initial admin password. Once the container is running, password changes must be made through the Web UI or terminal.
+
+## Solution
+
+### Option 1: Change via Web UI
+
+If the current admin password is known:
+
+1. Log in to the OpenCloud Web Interface.
+2. Navigate to Settings > Security.
+3. Enter your current password and choose a new one.
+
+> If the admin password is forgotten or you prefer command-line tools, use the terminal method below.
+
+### Option 2: Change via Terminal
+
+If the admin password is forgotten or needs to be changed via the terminal:
+
+#### Stop the Docker container
+
+First, stop your OpenCloud container:
+
+```bash
+docker compose stop opencloud
+```
+
+#### Run the password reset command
+
+Use the following command to reset the password:
+
+```bash
+sudo docker run -it --rm -v <opencloud-data-path>:/var/lib/opencloud -v <opencloud-config-path>:/etc/opencloud opencloudeu/opencloud:<opencloud-version> idm resetpassword
+```
+
+Replace:
+
+- `<opencloud-data-path>` with the Docker volume for OpenCloud data.
+- `<opencloud-config-path>` with the Docker volume for OpenCloud configuration.
+- `<opencloud-version>` with `latest` or your specific version.
+
+To find the volume names, list the current Docker volumes:
+
+```bash
+docker volume ls
+```
+
+Look for volumes such as:
+
+- `opencloud-compose_opencloud-data`
+- `opencloud-compose_opencloud-config`
+
+#### Example for the standard setup
+
+```bash
+sudo docker run -it --rm -v opencloud-compose_opencloud-data:/var/lib/opencloud -v opencloud-compose_opencloud-config:/etc/opencloud opencloudeu/opencloud:latest idm resetpassword
+```
+
+#### Start the container again
+
+```bash
+docker compose up -d
+```

docs/admin/resources/common-issues/containers-not-running.md

@@ -0,0 +1,44 @@
+---
+sidebar_position: 2
+id: containers-not-running
+title: OpenCloud containers are not running
+description: Check whether the OpenCloud containers are running
+draft: false
+hide_table_of_contents: true
+---
+
+# OpenCloud containers are not running
+
+## Problem
+
+OpenCloud is unavailable or does not work as expected.
+
+## Cause
+
+One or more required containers may not be running.
+
+## Solution
+
+Check the running containers:
+
+```bash
+docker ps
+```
+
+<img src={require("../img/common-issues/quick-docker-running.png").default} alt="Admin general" width="1920"/>
+
+Several containers should be listed, for example OpenCloud and Traefik.
+
+If an expected container is missing or not running, check the logs for errors or warnings:
+
+```bash
+docker compose logs
+```
+
+To inspect a specific service, add its name:
+
+```bash
+docker compose logs <service-name>
+```
+
+Use the log messages to identify the affected service and continue troubleshooting the reported error.