Commit 33799c40 authored by Amy Qualls's avatar Amy Qualls Committed by Nick Gaskill

Update Admin Area directions, Create docs, 2 of 2

parent 11be5622
...@@ -206,7 +206,7 @@ stop; ...@@ -206,7 +206,7 @@ stop;
After configuring your local PlantUML server, you're ready to enable the PlantUML integration: After configuring your local PlantUML server, you're ready to enable the PlantUML integration:
1. Sign in to GitLab as an [Administrator](../../user/permissions.md) user. 1. Sign in to GitLab as an [Administrator](../../user/permissions.md) user.
1. In the top menu, click **{admin}** **Admin Area**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, go to **Settings > General** and expand the **PlantUML** section. 1. In the left sidebar, go to **Settings > General** and expand the **PlantUML** section.
1. Select the **Enable PlantUML** check box. 1. Select the **Enable PlantUML** check box.
1. Set the PlantUML instance as `https://gitlab.example.com/-/plantuml/`, 1. Set the PlantUML instance as `https://gitlab.example.com/-/plantuml/`,
......
...@@ -76,7 +76,8 @@ You can skip this step if you already have your GitLab repositories searchable i ...@@ -76,7 +76,8 @@ You can skip this step if you already have your GitLab repositories searchable i
### Configure your GitLab instance with Sourcegraph ### Configure your GitLab instance with Sourcegraph
1. In GitLab, go to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Sourcegraph** configuration section. 1. Expand the **Sourcegraph** configuration section.
1. Check **Enable Sourcegraph**. 1. Check **Enable Sourcegraph**.
1. Set the Sourcegraph URL to your Sourcegraph instance, such as `https://sourcegraph.example.com`. 1. Set the Sourcegraph URL to your Sourcegraph instance, such as `https://sourcegraph.example.com`.
......
...@@ -82,14 +82,19 @@ See [server hooks](../administration/server_hooks.md) for more information. ...@@ -82,14 +82,19 @@ See [server hooks](../administration/server_hooks.md) for more information.
## Enabling push rules ## Enabling push rules
NOTE: You can create push rules for all new projects to inherit, but they can be overridden
GitLab administrators can set push rules globally under at the project level or the [group level](../user/group/index.md#group-push-rules).
**Admin Area > Push Rules** that all new projects inherit. You can later
override them in a project's settings. They can be also set on a [group level](../user/group/index.md#group-push-rules). To create global push rules:
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Push rules**.
To override global push rules in a project's settings:
1. Navigate to your project's **Settings > Repository** and expand **Push rules** 1. Navigate to your project's **Settings > Repository** and expand **Push rules**.
1. Set the rule you want 1. Set the rule you want.
1. Click **Save Push Rules** for the changes to take effect 1. Select **Save Push Rules** for the changes to take effect.
The following options are available: The following options are available:
......
...@@ -24,7 +24,8 @@ This affects merge requests and branch comparison views. ...@@ -24,7 +24,8 @@ This affects merge requests and branch comparison views.
To set the maximum diff patch size: To set the maximum diff patch size:
1. Go to the Admin Area (**{admin}**) and select **Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand **Diff limits**. 1. Expand **Diff limits**.
1. Enter a value for **Maximum diff patch size**, measured in bytes. 1. Enter a value for **Maximum diff patch size**, measured in bytes.
1. Select **Save changes**. 1. Select **Save changes**.
......
...@@ -15,8 +15,8 @@ project level. ...@@ -15,8 +15,8 @@ project level.
To enable merge request approval rules for an instance: To enable merge request approval rules for an instance:
1. Navigate to **Admin Area >** **{push-rules}** **Push Rules** and expand **Merge 1. On the top bar, select **Menu >** **{admin}** **Admin**.
requests approvals**. 1. In the left sidebar, select **{push-rules}** **Push Rules**, and expand **Merge request (MR) approvals**.
1. Set the required rule. 1. Set the required rule.
1. Click **Save changes**. 1. Click **Save changes**.
......
...@@ -9,18 +9,22 @@ type: reference ...@@ -9,18 +9,22 @@ type: reference
## Default projects limit ## Default projects limit
You can change the default maximum number of projects that users can create in their personal namespace. You can change the default maximum number of projects that users can create in their personal namespace:
Navigate to **Admin Area > Settings > General**, then expand **Account and Limit**.
You can increase or decrease that `Default projects limit` value.
- If you set `Default projects limit` to 0, users are not allowed to create projects 1. On the top bar, select **Menu >** **{admin}** **Admin**.
in their users personal namespace. However, projects can still be created in a group. 1. In the left sidebar, select **Settings > General**, then expand **Account and limit**.
1. 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.
## Max attachment size ## Max attachment size
You can change the maximum file size for attachments in comments and replies in GitLab. You can change the maximum file size for attachments in comments and replies in GitLab:
Navigate to **Admin Area > Settings > General**, then expand **Account and Limit**.
From here, you can increase or decrease by changing the value in `Maximum attachment size (MB)`. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**, then expand **Account and limit**.
1. Increase or decrease by changing the value in **Maximum attachment size (MB)**.
NOTE: NOTE:
If you choose a size larger than the configured value for the web server, If you choose a size larger than the configured value for the web server,
...@@ -29,9 +33,11 @@ details. ...@@ -29,9 +33,11 @@ details.
## Max push size ## Max push size
You can change the maximum push size for your repository. You can change the maximum push size for your repository:
Navigate to **Admin Area > Settings > General**, then expand **Account and Limit**.
From here, you can increase or decrease by changing the value in `Maximum push size (MB)`. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**, then expand **Account and limit**.
1. Increase or decrease by changing the value in **Maximum push size (MB)**.
NOTE: NOTE:
When you [add files to a repository](../../project/repository/web_editor.md#create-a-file) When you [add files to a repository](../../project/repository/web_editor.md#create-a-file)
...@@ -42,9 +48,11 @@ Use [Git LFS](../../../topics/git/lfs/index.md) to add large files to a reposito ...@@ -42,9 +48,11 @@ Use [Git LFS](../../../topics/git/lfs/index.md) to add large files to a reposito
## Max import size ## Max import size
You can change the maximum file size for imports in GitLab. You can change the maximum file size for imports in GitLab:
Navigate to **Admin Area > Settings > General**, then expand **Account and Limit**.
From here, you can increase or decrease by changing the value in `Maximum import size (MB)`. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**, then expand **Account and limit**.
1. Increase or decrease by changing the value in **Maximum import size (MB)**.
NOTE: NOTE:
If you choose a size larger than the configured value for the web server, If you choose a size larger than the configured value for the web server,
...@@ -62,7 +70,8 @@ A prefix can help you identify PATs visually, as well as with automation tools. ...@@ -62,7 +70,8 @@ A prefix can help you identify PATs visually, as well as with automation tools.
Only a GitLab administrator can set the prefix, which is a global setting applied Only a GitLab administrator can set the prefix, which is a global setting applied
to any PAT generated in the system by any user: to any PAT generated in the system by any user:
1. Navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Fill in the **Personal Access Token prefix** field. 1. Fill in the **Personal Access Token prefix** field.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -104,7 +113,8 @@ These settings can be found in: ...@@ -104,7 +113,8 @@ These settings can be found in:
1. Fill in the **Repository size limit (MB)** field in the **Naming, visibility** section. 1. Fill in the **Repository size limit (MB)** field in the **Naming, visibility** section.
1. Click **Save changes**. 1. Click **Save changes**.
- GitLab global settings: - GitLab global settings:
1. From the Dashboard, navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Fill in the **Size limit per repository (MB)** field. 1. Fill in the **Size limit per repository (MB)** field.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -150,7 +160,8 @@ GitLab administrators can choose to customize the session duration (in minutes) ...@@ -150,7 +160,8 @@ GitLab administrators can choose to customize the session duration (in minutes)
To set a limit on how long these sessions are valid: To set a limit on how long these sessions are valid:
1. Navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Fill in the **Session duration for Git operations when 2FA is enabled (minutes)** field. 1. Fill in the **Session duration for Git operations when 2FA is enabled (minutes)** field.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -174,7 +185,8 @@ there are no restrictions. ...@@ -174,7 +185,8 @@ there are no restrictions.
To set a lifetime on how long personal access tokens are valid: To set a lifetime on how long personal access tokens are valid:
1. Navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Fill in the **Maximum allowable lifetime for personal access tokens (days)** field. 1. Fill in the **Maximum allowable lifetime for personal access tokens (days)** field.
1. Click **Save changes**. 1. Click **Save changes**.
...@@ -196,7 +208,8 @@ By default, expired SSH keys **are not usable**. ...@@ -196,7 +208,8 @@ By default, expired SSH keys **are not usable**.
To allow the use of expired SSH keys: To allow the use of expired SSH keys:
1. Navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Uncheck the **Enforce SSH key expiration** checkbox. 1. Uncheck the **Enforce SSH key expiration** checkbox.
...@@ -212,7 +225,8 @@ You can allow the use of expired PATs with the following steps: ...@@ -212,7 +225,8 @@ You can allow the use of expired PATs with the following steps:
To do this: To do this:
1. Navigate to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Account and limit** section. 1. Expand the **Account and limit** section.
1. Uncheck the **Enforce personal access token expiration** checkbox. 1. Uncheck the **Enforce personal access token expiration** checkbox.
...@@ -224,8 +238,9 @@ To maintain integrity of user details in [Audit Events](../../../administration/ ...@@ -224,8 +238,9 @@ To maintain integrity of user details in [Audit Events](../../../administration/
To do this: To do this:
1. Navigate to **Admin Area > Settings > General**, then expand **Account and Limit**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. Check the **Prevent users from changing their profile name** checkbox. 1. In the left sidebar, select **Settings > General**, then expand **Account and limit**.
1. Select the **Prevent users from changing their profile name** checkbox.
NOTE: NOTE:
When this ability is disabled, GitLab administrators can still use the When this ability is disabled, GitLab administrators can still use the
......
...@@ -9,13 +9,16 @@ type: index ...@@ -9,13 +9,16 @@ type: index
As an administrator of a GitLab self-managed instance, you can manage the behavior of your deployment. To do so, select **Admin Area > Settings**. As an administrator of a GitLab self-managed instance, you can manage the behavior of your deployment. To do so, select **Admin Area > Settings**.
The admin area is not accessible on GitLab.com, and settings can only be changed by the The Admin Area is not accessible on GitLab.com, and settings can only be changed by the
GitLab.com administrators. See the [GitLab.com settings](../../gitlab_com/index.md) GitLab.com administrators. See the [GitLab.com settings](../../gitlab_com/index.md)
documentation for all current settings and limits on the GitLab.com instance. documentation for all current settings and limits on the GitLab.com instance.
## General ## General
Access the default page for Admin Area settings by navigating to **Admin Area > Settings > General**: To access the default page for Admin Area settings:
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
| Option | Description | | Option | Description |
| ------ | ----------- | | ------ | ----------- |
...@@ -116,6 +119,11 @@ Access the default page for Admin Area settings by navigating to **Admin Area > ...@@ -116,6 +119,11 @@ Access the default page for Admin Area settings by navigating to **Admin Area >
| [Gitaly timeouts](gitaly_timeouts.md) | Configure Gitaly timeouts. | | [Gitaly timeouts](gitaly_timeouts.md) | Configure Gitaly timeouts. |
| Localization | [Default first day of the week](../../profile/preferences.md) and [Time tracking](../../project/time_tracking.md#limit-displayed-units-to-hours). | | Localization | [Default first day of the week](../../profile/preferences.md) and [Time tracking](../../project/time_tracking.md#limit-displayed-units-to-hours). |
NOTE: ### Default first day of the week
You can change the [Default first day of the week](../../profile/preferences.md) for the entire GitLab instance
in the **Localization** section of **Admin Area > Settings > Preferences**. You can change the [Default first day of the week](../../profile/preferences.md)
for the entire GitLab instance:
1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Preferences**.
1. Scroll to the **Localization** section, and select your desired first day of the week.
...@@ -17,12 +17,17 @@ while the project remains secure. ...@@ -17,12 +17,17 @@ while the project remains secure.
## Configuration ## Configuration
As an administrator, navigate to **Admin Area > Settings > Templates** and To select a project to serve as the custom template repository:
select the project to serve as the custom template repository.
![File templates in the Admin Area](img/file_template_admin_area.png) 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Templates**.
1. Select the project:
After that, you can add custom templates to the selected repository and use them for the entire instance. ![File templates in the Admin Area](img/file_template_admin_area.png)
1. Add custom templates to the selected repository.
After you add templates, you can use them for the entire instance.
They are available in the [Web Editor's dropdown](../../project/repository/web_editor.md#template-dropdowns) They are available in the [Web Editor's dropdown](../../project/repository/web_editor.md#template-dropdowns)
and through the [API settings](../../../api/settings.md). and through the [API settings](../../../api/settings.md).
......
...@@ -23,9 +23,14 @@ branches), only 1 bulk push event is created instead of 1,000 push ...@@ -23,9 +23,14 @@ branches), only 1 bulk push event is created instead of 1,000 push
events. This helps in maintaining good system performance and preventing spam on events. This helps in maintaining good system performance and preventing spam on
the activity feed. the activity feed.
This setting can be modified in **Admin Area > Settings > Network > Performance Optimization**. To modify this setting:
This can also be configured via the [Application settings API](../../../api/settings.md#list-of-settings-that-can-be-accessed-via-api-calls)
as `push_event_activities_limit`. The default value is 3, but it can be greater - In the Admin Area:
than or equal 0. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Network**, then expand **Performance optimization**.
- Through the [Application settings API](../../../api/settings.md#list-of-settings-that-can-be-accessed-via-api-calls)
as `push_event_activities_limit`.
The default value is 3, but it can be greater than or equal 0.
![Push event activities limit](img/push_event_activities_limit_v12_4.png) ![Push event activities limit](img/push_event_activities_limit_v12_4.png)
...@@ -11,8 +11,9 @@ GitLab allows administrators to enforce specific controls. ...@@ -11,8 +11,9 @@ GitLab allows administrators to enforce specific controls.
To access the visibility and access control options: To access the visibility and access control options:
1. Sign in to GitLab as a user with Administrator [permissions](../../permissions.md). 1. Sign in to GitLab as a user with [Administrator role](../../permissions.md).
1. Go to **Admin Area > Settings > General**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**.
1. Expand the **Visibility and access controls** section. 1. Expand the **Visibility and access controls** section.
## Default branch protection ## Default branch protection
......
...@@ -65,7 +65,8 @@ GitLab [administrators](../../../permissions.md) of self-managed instances can ...@@ -65,7 +65,8 @@ GitLab [administrators](../../../permissions.md) of self-managed instances can
customize the initial branch for projects hosted on that instance. Individual customize the initial branch for projects hosted on that instance. Individual
groups and subgroups can override this instance-wide setting for their projects. groups and subgroups can override this instance-wide setting for their projects.
1. Go to **Admin Area > Settings > Repository**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > Repository**.
1. Expand **Default initial branch name**. 1. Expand **Default initial branch name**.
1. Change the default initial branch to a custom name of your choice. 1. Change the default initial branch to a custom name of your choice.
1. Select **Save changes**. 1. Select **Save changes**.
......
...@@ -267,7 +267,7 @@ a `main` entry point inside the Web IDE. ...@@ -267,7 +267,7 @@ a `main` entry point inside the Web IDE.
Live Preview is enabled for all projects on GitLab.com. If you are an administrator Live Preview is enabled for all projects on GitLab.com. If you are an administrator
of a self-managed GitLab instance, and you want to enable Live Preview: of a self-managed GitLab instance, and you want to enable Live Preview:
1. In the top navigation bar, go to **Admin Area**. 1. On the top bar, select **Menu >** **{admin}** **Admin**.
1. In the left sidebar, select **Settings > General**. 1. In the left sidebar, select **Settings > General**.
1. Scroll to **Web IDE** and select **Expand**: 1. Scroll to **Web IDE** and select **Expand**:
![Administrator Live Preview setting](img/admin_live_preview_v13_0.png) ![Administrator Live Preview setting](img/admin_live_preview_v13_0.png)
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment