# Password Reset

### Overview

ZigiOps provides two ways to update a user's password: a self-service option through **Profile Preferences**, and an admin-enforced option through **User Management**. Both methods are straightforward and require no technical expertise.

### Changing Your Own Password (Self-Service)

Any logged-in user can change their own account password at any time through the Profile Preferences menu.

ZigiOps → Preferences → Profile Preferences

Follow the steps below to change your password.

1. Access the ZigiOps web console.
2. Click on the **Preferences → Profile Preferences** button.
3. Locate the password section of the form.
4. Enter your **current (old) password** in the first field.
5. Enter your **new password** in the second field.
6. Re-enter your **new password** in the confirmation field.
7. Click the **Save** button to apply the change.

**Note:** You must know your current password to complete this process. If you have forgotten your password, contact your ZigiOps Super Admin to have it reset.

### Admin-Enforced Password Reset

A user with the **Super Admin** role can force a password reset for any other local user. This is done during user creation or by editing the user record in the User Management page.

ZigiOps → Admin → User Management

Follow the steps below to enforce a password reset for another user.

1. Navigate to **ZigiOps → Admin → User Management**.
2. Locate the target user in the list.
3. Enable the **Enforce Password Change** option for that user.
4. Save the changes.

The next time the affected user logs in, ZigiOps will redirect them to the change password screen before granting access to the platform.

### First Login - Mandatory Password Change

When you log in to a new ZigiOps instance for the first time using the default credentials, the platform automatically requires you to set a new password before proceeding.

1. Open your supported browser and navigate to your ZigiOps URL in the format `HTTPS://<IP/FQDN>:<PORT>`. For example, `https://zigiops.example.com:8585`.
2. Log in using the default username and password (see the table below).
3. On the change password screen, enter the default password in the **Old Password** field.
4. Enter and confirm your new password.
5. Click **Save** to proceed to the ZigiOps console.

### Default Access Credentials

| Component                                       | Default Value |
| ----------------------------------------------- | ------------- |
| Default Protocol                                | `HTTPS`       |
| Default Port                                    | `8585`        |
| Default Username                                | `admin`       |
| Default Password (version 2022.07.295 or newer) | `admin@Z1G1`  |
| Default Password (version 2022.06.255 or older) | `admin`       |

### User Lockout

ZigiOps includes an optional user lockout mechanism that can be configured in **General Settings**. When enabled, users who fail to authenticate a certain number of times are temporarily locked out of the platform.

Administrators can configure two parameters for this feature:

**Number of Failed Attempts:** The number of unsuccessful login attempts before the user is locked out.

**Lockout Period:** The duration of the lockout after the threshold is reached.

ZigiOps → Settings → General Settings → Platform → User Lockout

### Frequently Asked Questions

<details>

<summary>How do I reset my ZigiOps password if I forgot it?</summary>

ZigiOps does not currently provide a self-service "Forgot Password" flow. If you have forgotten your password, contact your ZigiOps Super Admin to have it updated via the User Management page.

</details>

<details>

<summary>Can I change another user's password in ZigiOps?</summary>

Super Admins can enforce a password reset for any local user via the User Management page. They set a temporary password and enable the "Enforce Password Change" option, requiring the user to create a new password on next login.

</details>

<details>

<summary>What happens if a user is locked out?</summary>

A locked-out user will be unable to log in for the duration of the configured lockout period. A Super Admin can review and adjust the lockout settings at any time via General Settings.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigiwave.com/administration/password-reset.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.