> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/open-source/use-harness-open-source/administration-1/user-management.md).

# User Management

A user is either an administrator, or a regular user. User management is only accessible to administrators.

## Administrators <a href="#administrators" id="administrators"></a>

Administrators have full access to all users, projects and repositories in a Harness Open Source instance.

{% hint style="warning" %}
By default, the first user to login to a Harness Open Source instance will be configured as an administrator.

This behavior can be overridden by [GITNESS\_PRINCIPAL\_ADMIN\_PASSWORD](/open-source/new-to-harness-open-source/settings.md#gitness_principal_admin_password).
{% endhint %}

## Users <a href="#users" id="users"></a>

Users can create their own projects and access existing projects where they are a [member](/open-source/use-harness-open-source/administration-1/project-management.md).

{% hint style="warning" %}
By default, anyone who can access the Harness Open Source instance can create a user account.

This behavior can be overridden by [GITNESS\_USER\_SIGNUP\_ENABLED](/open-source/new-to-harness-open-source/settings.md#gitness_user_signup_enabled).
{% endhint %}

## Add a new user <a href="#add-a-new-user" id="add-a-new-user"></a>

1. Select **User Management** from the menu on the left, then select **New User**
2. Add the required details and select **Create User**
3. Harness Open Source will automatically generate a random password, share this password with the user

## Set admin access <a href="#set-admin-access" id="set-admin-access"></a>

1. Open the **User Management** view from the menu on the left, then locate the user in the list
2. From the [vertical ellipsis](https://en.wikipedia.org/wiki/Ellipsis) menu on the right, select **Set as admin**, then select **Confirm**

## Remove admin access <a href="#remove-admin-access" id="remove-admin-access"></a>

1. Open the **User Management** view from the menu on the left, then locate the user in the list
2. From the [vertical ellipsis](https://en.wikipedia.org/wiki/Ellipsis) menu on the right, select **Remove admin**, then select **Confirm**

## Reset a user's password <a href="#reset-a-users-password" id="reset-a-users-password"></a>

1. Open the **User Management** view from the menu on the left, then locate the user in the list
2. From the [vertical ellipsis](https://en.wikipedia.org/wiki/Ellipsis) menu on the right, select **Reset password**, then select **Confirm**
3. Harness Open Source will generate a new random password, share this password with the user

## User account settings <a href="#user-account-settings" id="user-account-settings"></a>

Users can manage their Harness Open Source profile by selecting their username from the menu on the left.

Users can also reset their password from this view.

## Generate user token <a href="#generate-user-token" id="generate-user-token"></a>

Users can interact with the Harness Open Source [API](https://github.com/iKettles/harness-gitbook/tree/main/open-source/use-harness-open-source/reference/api/overview/README.md) via authentication tokens.

1. Select your username from the menu on the left
2. Select **New token** and give the token a name
3. Choose a number of days the token will be valid from the **Expiration** menu, then select **Generate token**

{% hint style="warning" %}
Tokens carry many privileges; treat your user tokens as passwords and store them securely.
{% endhint %}