Creating users

You can create users:

Manually through the sign-in page .
• Manually in the Admin Area .
• Manually using the API .
• Automatically through user authentication integrations .

Create users on sign-in page

Prerequisite:

Sign-up must be enabled .

Users can create their own accounts by either:

• Selecting the Register now link on the sign-in page.
• Navigating to your GitLab instance’s sign-up link. For example: https://gitlab.example.com/users/sign_up .

Create users in Admin Area

Prerequisite:

• You must have administrator access to the instance.

To create a user manually:

1. On the top bar, select Main menu > Admin .
2. On the left sidebar, select Overview > Users ( /admin/users ).
3. Select New user .
4. Complete the required fields, such as name, username, and email.
5. Select Create user .

A reset link is sent to the user’s email and they are forced to set their password on first sign in.

To set a user’s password without relying on the email confirmation, after you create a user following the previous steps:

1. Select the user.
2. Select Edit .
3. Complete the password and password confirmation fields.
4. Select Save changes .

The user can now sign in with the new username and password, and they are asked to change the password you set up for them.

Create users through authentication integrations

Users are:

• Automatically created upon first sign in with the LDAP integration .
• Created when first signing in using an OmniAuth provider if the allow_single_sign_on setting is present.
• Created when first signing with Group SAML .
• Automatically created by SCIM when the user is created in the identity provider.

Create users through the Rails console

Commands that change data can cause damage if not run correctly or under the right conditions. Always run commands in a test environment first and have a backup instance ready to restore.

To create a user through the Rails console:

Start a Rails console session .

1. Run the following commands:

   u = User.new(username: 'test_user', email: 'test@example.com', name: 'Test User', password: 'password', password_confirmation: 'password')
   u.skip_confirmation! # Use it only if you wish user to be automatically confirmed. If skipped, user receives confirmation e-mail
   u.save!
   Docs
   Edit this page
   to fix an error or add an improvement in a merge request.
   
   Create an issue
   to suggest an improvement to this page.
   
   Product
   Create an issue
   if there's something you don't like about this feature.
   
   Propose functionality
   by submitting a feature request.
   
   Join First Look
   to help shape new features.
   Feature availability and product trials
   View pricing
   to see all GitLab tiers and features, or to upgrade.
   
   Try GitLab for free
   with access to all features for 30 days.
   
   Get Help
   
   If you didn't find what you were looking for,
   search the docs.
   
   If you want help with something specific and could use community support,
   post on the GitLab forum.
   
   For problems setting up or using this feature (depending on your GitLab
   subscription).
   
   Request support