Skip to content

GitLab

Account and limit settings (FREE SELF)

Default projects limit

You can configure the default maximum number of projects new users can create in their personal namespace. This limit affects only new user accounts created after you change the setting. This setting is not retroactive for existing users, but you can separately edit the project limits for existing users.

To configure the maximum number of projects in personal namespaces for new users:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General, then expand Account and limit.
  3. Increase or decrease that Default projects limit value.

If you set Default projects limit to 0, users are not allowed to create projects in their users personal namespace. However, projects can still be created in a group.

Projects limit for a user

You can edit a specific user, and change the maximum number of projects this user can create in their personal namespace:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Overview > Users.
  3. From the list of users, select a user.
  4. Select Edit.
  5. Increase or decrease the Projects limit value.

Max attachment size

You can change the maximum file size for attachments in comments and replies in GitLab:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General, then expand Account and limit.
  3. Increase or decrease by changing the value in Maximum attachment size (MB).

NOTE: If you choose a size larger than the configured value for the web server, you may receive errors. See the troubleshooting section for more details.

Max push size

You can change the maximum push size for your repository:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General, then expand Account and limit.
  3. Increase or decrease by changing the value in Maximum push size (MB).

NOTE: When you add files to a repository through the web UI, the maximum attachment size is the limiting factor, because the web server must receive the file before GitLab can generate the commit. Use Git LFS to add large files to a repository.

Max import size

You can change the maximum file size for imports in GitLab:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General, then expand Account and limit.
  3. Increase or decrease by changing the value in Maximum import size (MB).

NOTE: If you choose a size larger than the configured value for the web server, you may receive errors. See the troubleshooting section for more details.

Personal access token prefix

You can specify a prefix for personal access tokens. You might use a prefix to find tokens more quickly, or for use with automation tools.

The default prefix is glpat- but administrators can change it.

Project access tokens also inherit this prefix.

Set a prefix

To change the default global prefix:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Fill in the Personal Access Token prefix field.
  5. Click Save changes.

You can also configure the prefix by using the settings API.

Repository size limit (PREMIUM SELF)

Repositories in your GitLab instance can grow quickly, especially if you are using LFS. Their size can grow exponentially, rapidly consuming available storage. To prevent this from happening, you can set a hard limit for your repositories' size. This limit can be set globally, per group, or per project, with per project limits taking the highest priority.

There are numerous use cases where you might set up a limit for repository size. For instance, consider the following workflow:

  1. Your team develops apps which require large files to be stored in the application repository.
  2. Although you have enabled Git LFS to your project, your storage has grown significantly.
  3. Before you exceed available storage, you set up a limit of 10 GB per repository.

How it works

Only a GitLab administrator can set those limits. Setting the limit to 0 means there are no restrictions.

These settings can be found in:

  • Each project's settings:
    1. From the Project's homepage, navigate to Settings > General.
    2. Fill in the Repository size limit (MB) field in the Naming, topics, avatar section.
    3. Click Save changes.
  • Each group's settings:
    1. From the Group's homepage, navigate to Settings > General.
    2. Fill in the Repository size limit (MB) field in the Naming, visibility section.
    3. Click Save changes.
  • GitLab global settings:
    1. On the top bar, select Menu > Admin.
    2. On the left sidebar, select Settings > General.
    3. Expand the Account and limit section.
    4. Fill in the Size limit per repository (MB) field.
    5. Click Save changes.

The first push of a new project, including LFS objects, is checked for size. If the sum of their sizes exceeds the maximum allowed repository size, the push is rejected.

NOTE: The repository size limit includes repository files and LFS, but does not include artifacts, uploads, wiki, packages, or snippets. The repository size limit applies to both private and public projects.

For details on manually purging files, see reducing the repository size using Git.

NOTE: For GitLab.com repository size limits, see accounts and limit settings.

Troubleshooting

413 Request Entity Too Large

When attaching a file to a comment or reply in GitLab displays a 413 Request Entity Too Large error, the max attachment size is probably larger than the web server's allowed value.

To increase the max attachment size to 200 MB in a Omnibus GitLab install, you may need to add the line below to /etc/gitlab/gitlab.rb before increasing the max attachment size:

nginx['client_max_body_size'] = "200m"

Customize session duration for Git Operations when 2FA is enabled (PREMIUM SELF)

  • Introduced in GitLab 13.9.
  • It's deployed behind a feature flag, disabled by default.
  • It's disabled on GitLab.com.
  • It's not recommended for production use.
  • To use it in GitLab self-managed instances, ask a GitLab administrator to enable it.

NOTE: This feature is under development and not ready for production use. It is deployed behind a feature flag that is disabled by default. To use it in GitLab self-managed instances, ask a GitLab administrator to enable it.

GitLab administrators can choose to customize the session duration (in minutes) for Git operations when 2FA is enabled. The default is 15 and this can be set to a value between 1 and 10080.

To set a limit on how long these sessions are valid:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Fill in the Session duration for Git operations when 2FA is enabled (minutes) field.
  5. Click Save changes.

Limit the lifetime of SSH keys (ULTIMATE SELF)

FLAG: On self-managed GitLab, by default this feature is available. To hide the feature, ask an administrator to disable the feature flag named ff_limit_ssh_key_lifetime. On GitLab.com, this feature is not available.

Users can optionally specify a lifetime for SSH keys. This lifetime is not a requirement, and can be set to any arbitrary number of days.

SSH keys are user credentials to access GitLab. However, organizations with security requirements may want to enforce more protection by requiring the regular rotation of these keys.

Set a lifetime

Only a GitLab administrator can set a lifetime. Leaving it empty means there are no restrictions.

To set a lifetime on how long SSH keys are valid:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Fill in the Maximum allowable lifetime for SSH keys (days) field.
  5. Click Save changes.

Once a lifetime for SSH keys is set, GitLab:

  • Requires users to set an expiration date that is no later than the allowed lifetime on new SSH keys.
  • Applies the lifetime restriction to existing SSH keys. Keys with no expiry or a lifetime greater than the maximum immediately become invalid.

NOTE: When a user's SSH key becomes invalid they can delete and re-add the same key again.

Allow expired SSH keys to be used (ULTIMATE SELF)

By default, expired SSH keys are not usable.

To allow the use of expired SSH keys:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Uncheck the Enforce SSH key expiration checkbox.

Disabling SSH key expiration immediately enables all expired SSH keys.

Limit the lifetime of personal access tokens (ULTIMATE SELF)

Introduced in GitLab 12.6.

Users can optionally specify a lifetime for personal access tokens. This lifetime is not a requirement, and can be set to any arbitrary number of days.

Personal access tokens are the only tokens needed for programmatic access to GitLab. However, organizations with security requirements may want to enforce more protection by requiring the regular rotation of these tokens.

Set a lifetime

Only a GitLab administrator can set a lifetime. Leaving it empty means there are no restrictions.

To set a lifetime on how long personal access tokens are valid:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Fill in the Maximum allowable lifetime for personal access tokens (days) field.
  5. Click Save changes.

Once a lifetime for personal access tokens is set, GitLab:

  • Applies the lifetime for new personal access tokens, and require users to set an expiration date and a date no later than the allowed lifetime.
  • After three hours, revoke old tokens with no expiration date or with a lifetime longer than the allowed lifetime. Three hours is given to allow administrators to change the allowed lifetime, or remove it, before revocation takes place.

Allow expired Personal Access Tokens to be used (ULTIMATE SELF)

By default, expired personal access tokens (PATs) are not usable.

To allow the use of expired PATs:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General.
  3. Expand the Account and limit section.
  4. Uncheck the Enforce personal access token expiration checkbox.

Disable user profile name changes (PREMIUM SELF)

Introduced in GitLab 12.7.

To maintain integrity of user details in Audit Events, GitLab administrators can choose to disable a user's ability to change their profile name.

To do this:

  1. On the top bar, select Menu > Admin.
  2. On the left sidebar, select Settings > General, then expand Account and limit.
  3. Select the Prevent users from changing their profile name checkbox.

NOTE: When this ability is disabled, GitLab administrators can still use the Admin UI or the API to update usernames.