From 7dedfd104619c75b17500dfb4418af978f1ae7af Mon Sep 17 00:00:00 2001 From: Heiko Pohl Date: Tue, 13 May 2025 11:00:07 +0200 Subject: [PATCH 1/2] fix admin password issue --- docs/admin/resources/common-issues.md | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/admin/resources/common-issues.md b/docs/admin/resources/common-issues.md index 512ca6e1..1d95104c 100644 --- a/docs/admin/resources/common-issues.md +++ b/docs/admin/resources/common-issues.md @@ -73,4 +73,24 @@ This can pose a security risk in shared or multi-user environments. Make sure to ::: -Ensure you apply this to all relevant folders that are mounted into your containers. This will grant the Docker container the necessary permissions to access and write to these directories. \ No newline at end of file +Ensure you apply this to all relevant folders that are mounted into your containers. This will grant the Docker container the necessary permissions to access and write to these directories. + +--- + +### Change Admin-Passwort in .env file + +If you set an admin password in the .env file during the initial setup of OpenCloud, you CANNOT simply change it in the file again.
+There are two ways to change the password: + +#### 1. Web UI +The admin can change the password in the web UI if the admin password is known. +If the password is unknown or the user does not want to make the change in the web UI, there is still the option via the terminal. + +#### 2. Terminal +If the admin password has been forgotten or you want to make the change via the terminal, you must enter the following command in the terminal to reset the password: + +```bash +sudo docker run -it --rm \ -v < opencloud-data-path>:/var/lib/opencloud \ -v :/etc/opencloud \ opencloudeu/opencloud: idm resetpassword +``` + +Once the command has been successfully executed in the terminal and the password has been reset, it can be reassigned in the .env file. \ No newline at end of file From a6552c8a48537f0ef2875db48129a30286a1a312 Mon Sep 17 00:00:00 2001 From: Heiko Pohl Date: Tue, 13 May 2025 11:23:51 +0200 Subject: [PATCH 2/2] fix admin password issue refine --- docs/admin/resources/common-issues.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/admin/resources/common-issues.md b/docs/admin/resources/common-issues.md index 1d95104c..4cf7e962 100644 --- a/docs/admin/resources/common-issues.md +++ b/docs/admin/resources/common-issues.md @@ -89,6 +89,7 @@ If the password is unknown or the user does not want to make the change in the w #### 2. Terminal If the admin password has been forgotten or you want to make the change via the terminal, you must enter the following command in the terminal to reset the password: +**Example for Docker:** ```bash sudo docker run -it --rm \ -v < opencloud-data-path>:/var/lib/opencloud \ -v :/etc/opencloud \ opencloudeu/opencloud: idm resetpassword ```