From 13856a1fb33b1f2f07dddb32ac07db2bb0e82da3 Mon Sep 17 00:00:00 2001
From: Mohamed Bassem <me@mbassem.com>
Date: Sun, 7 Sep 2025 17:51:12 +0000
Subject: release(docs): release the 0.27 docs

---
 docs/versioned_docs/version-v0.27.0/11-FAQ.md | 60 +++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/versioned_docs/version-v0.27.0/11-FAQ.md

(limited to 'docs/versioned_docs/version-v0.27.0/11-FAQ.md')

diff --git a/docs/versioned_docs/version-v0.27.0/11-FAQ.md b/docs/versioned_docs/version-v0.27.0/11-FAQ.md
new file mode 100644
index 00000000..e6f59801
--- /dev/null
+++ b/docs/versioned_docs/version-v0.27.0/11-FAQ.md
@@ -0,0 +1,60 @@
+# Frequently Asked Questions (FAQ)
+
+## User Management
+
+### Lost password
+
+#### If you are not an administrator
+
+Administrators can reset the password of any user. Contact an administrator to reset the password for you.
+
+- Navigate to the `Admin Settings` page
+- Find the user in the `Users List`
+- In the `Actions` column, there is a button to reset the password
+- Enter a new password and press `Reset`
+- The new password is now set
+- If required, you can change your password again (so the admin does not know your password) in the `User Settings`
+
+#### If you are an administrator
+
+If you are an administrator and lost your password, you have to reset the password in the database.
+
+To reset the password:
+
+- Acquire some kind of tools that helps you to connect to the database:
+  - `sqlite3` on Linux: run `apt-get install sqlite3` (depending on your package manager)
+  - e.g. `dbeaver` on Windows
+- Shut down Karakeep
+- Connect to the `db.db` database, which is located in the `data` directory you have mounted to your docker container:
+  - by e.g. running `sqlite3 db.db` (in your `data` directory)
+  - or going through e.g. the `dbeaver` UI to locate the file in the data directory and connecting to it
+- Update the password in the database by running:
+  - `update user set password='$2a$10$5u40XUq/cD/TmLdCOyZ82ePENE6hpkbodJhsp7.e/BgZssUO5DDTa', salt='' where email='<YOUR_EMAIL_HERE>';`
+  - (don't forget to put your email address into the command)
+- The new password for your user is now `adminadmin`.
+- Start Karakeep again
+- Log in with your email address and the password `adminadmin` and change the password to whatever you want in the `User Settings`
+
+### Adding another administrator
+
+By default, the first user to sign up gets promoted to administrator automatically.
+
+In case you want to grant those permissions to another user:
+
+- Navigate to the `Admin Settings` page
+- Find the user in the `Users List`
+- In the `Actions` column, there is a button to change the Role
+- Change the Role to `Admin`
+- Press `Change`
+- The new administrator has to log out and log in again to get the new role assigned
+
+### Adding new users, when signups are disabled
+
+Administrators can create new accounts any time:
+
+- Navigate to the `Admin Settings` page
+- Go to the `Users List`
+- Press the `Create User` Button.
+- Enter the information for the user
+- Press `create`
+- The new user can now log in
-- 
cgit v1.2.3-70-g09d2