Skip to main content

User Management

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

Administrators​

Administrators have full access to all users, projects and repositories in a Gitness instance.

caution

By default, the first user to login to your Gitness instance will be configured as an administrator.

This behavior can be overridden by GITNESS_PRINCIPAL_ADMIN_PASSWORD.

Users​

Users can create their own projects and access existing projects where they are a member.

caution

By default, anyone who can access your Gitness instance can create a user account.

This behavior can be overridden by GITNESS_USER_SIGNUP_ENABLED.

Add a new user​

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

Set admin access​

  1. Open the User Management view from the menu on the left, then locate the user in the list
  2. From the vertical ellipsis menu on the right, select Set as admin, then select Confirm

Remove admin access​

  1. Open the User Management view from the menu on the left, then locate the user in the list
  2. From the vertical ellipsis menu on the right, select Remove admin, then select Confirm

Reset a user's password​

  1. Open the User Management view from the menu on the left, then locate the user in the list
  2. From the vertical ellipsis menu on the right, select Reset password, then select Confirm
  3. Gitness will generate a new random password, share this password with the user

User account settings​

Users can manage their Gitness profile by selecting their username from the menu on the left.

Users can also reset their password from this view.

Generate user token​

Users can interact with the Gitness API 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
caution

Tokens carry many privileges; treat your user tokens as passwords and store them securely.