Skip to content

Commit 7eeba06

Browse files
authored
Fixed 404 + Push Update password page (#179)
* fixed title * fixed 404+ pushed username and password update page * fixed 404s --------- Co-authored-by: simranquirky <simranquirky>
1 parent 2f6ed48 commit 7eeba06

File tree

7 files changed

+77
-6
lines changed

7 files changed

+77
-6
lines changed

docs/api/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,9 @@ Make sure that you are sending the requests over HTTPS.
2222
1. [Schema](stream/schema)
2323
1. [Setting](stream/setting)
2424
1. [Ingestion](ingestion/)
25-
1. [Bulk](ingestion/bulk)
26-
1. [Json](ingestion/json)
27-
1. [Multi](ingestion/multi)
25+
1. [Bulk](ingestion/logs/bulk)
26+
1. [Json](ingestion/logs/json)
27+
1. [Multi](ingestion/logs/multi)
2828
1. [Search](search/)
2929
1. [Function](function/)
3030
1. [User](user/)

docs/user-guide/alerts/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,5 @@ Alerts enable continuous monitoring of log, metric, or trace data to detect crit
88
- [Templates](../management/templates/)
99
- [Import and Export Alerts](../alerts/import-export-alerts/)
1010
- [Alert Folders](../alerts/alert-folders/)
11-
- [Multi-window Selector in Scheduled Alerts (SQL Mode)](../alerts/]multi-window-selector-scheduled-alerts-concept)
11+
- [Multi-window Selector in Scheduled Alerts (SQL Mode)](../alerts/multi-window-selector-scheduled-alerts-concept)
1212
- [Use Multi-window Selector in Scheduled Alerts](../alerts/how-to-access-multi-window-selector-scheduled-alerts)

docs/user-guide/identity-and-access-management/.pages

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,5 @@ nav:
44
- Enable Role-Based Access Control (RBAC) in Enterprise Edition: enable-rbac-in-openobserve-enterprise.md
55
- Single Sign-On (SSO): sso.md
66
- Organizations: organizations.md
7-
- Quotas: quotas
7+
- Quotas: quotas
8+
- Manage Users & Passwords: update-password.md
72.7 KB
Loading
230 KB
Loading

docs/user-guide/identity-and-access-management/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,5 @@ The following guides provide details on managing user identities and controlling
44
- [Enable Role-Based Access Control (RBAC) in Enterprise Edition](../identity-and-access-management/enable-rbac-in-openobserve-enterprise/)
55
- [Single Sign-On (SSO)](../identity-and-access-management/sso/)
66
- [Organizations](../identity-and-access-management/organizations/)
7-
- [Quotas](../identity-and-access-management/quotas/)
7+
- [Quotas](../identity-and-access-management/quotas/)
8+
- [Manage Users & Passwords](../identity-and-access-management/update-password.md)
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: Updating Usernames and Passwords in OpenObserve
3+
description: >-
4+
Learn how to update usernames and passwords in OpenObserve via the UI or CLI. Includes steps for root password reset, best practices for credential rotation, and secure account management.
5+
---
6+
7+
# Updating Usernames and Passwords in OpenObserve
8+
9+
Managing credentials in OpenObserve is critical for securing your observability platform. Incorrect or outdated credentials can block access, cause downtime, or expose your system to security risks. This page explains how to update usernames and passwords through the UI or CLI, and provides best practices for secure credential management.
10+
11+
12+
## Overview
13+
14+
OpenObserve provides multiple ways to manage user credentials:
15+
16+
* [UI-based](#updating-passwords-via-the-openobserve-ui) updates for users and roles
17+
* [CLI-based](#resetting-the-root-password-via-cli) root password reset if locked out
18+
19+
## Updating Passwords via the OpenObserve UI
20+
21+
Use the OpenObserve UI to manage users easily.
22+
23+
**Steps:**
24+
25+
1. Log in as an administrator.
26+
2. Navigate to **IAM → Users**. Click the **Edit** icon under **Actions** for the user you want to update.
27+
![](images/users.png)
28+
3. Enable **Change Password** and enter the new password.
29+
![](images/enable-change-password.png){:style="height:300px"}
30+
4. Click **Save Changes**.
31+
5. Log out and verify that the updated credentials work.
32+
33+
> **Tip:** You can also update user roles at the same time to enforce correct permissions.
34+
35+
36+
## Resetting the Root Password via CLI
37+
38+
If you are locked out of the root account, you can reset the root password from the CLI.
39+
40+
**Steps:**
41+
42+
1. Set environment variables for the new root credentials:
43+
```bash
44+
export ZO_ROOT_USER_EMAIL="root@example.com"
45+
export ZO_ROOT_USER_PASSWORD="NewStrongPassword123"
46+
```
47+
48+
2. Run the reset command from your OpenObserve installation directory:
49+
```bash
50+
./openobserve reset -c root
51+
```
52+
53+
3. After the reset completes, log in with the updated root credentials.
54+
55+
> **Note:** For Docker or Kubernetes deployments, set the environment variables inside the container or pod before running the reset command.
56+
57+
58+
## Best Practices
59+
60+
* Update usernames, passwords, or roles via the UI whenever possible.
61+
* Update root and user passwords periodically; rotate API keys or service accounts.
62+
* Use long, complex, and unique passwords. Avoid reusing passwords across environments.
63+
* Back up your metadata database, especially before manual or DB-level changes.
64+
* Use dedicated users with least privilege; reserve root for emergencies.
65+
66+
## Next Steps
67+
68+
* Set up [alerts](../alerts/alerts.md) for failed logins to detect potential security issues.
69+
* Review [RBAC and role assignments](../identity-and-access-management/enable-rbac-in-openobserve-enterprise.md) to ensure least-privilege access.

0 commit comments

Comments
 (0)