Scanner Enablement Wizard
- Tier: Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
Use the Scanner Enablement Wizard to apply security configuration profiles to projects in a group. The wizard configures dependency scanning, SAST, and secret detection, and updates the coverage shown in the security inventory.
Prerequisites:
- To view scanner coverage, the Developer, Maintainer, or Owner role for the group.
- To enable scanners, the Security Manager, Maintainer, or Owner role for the group.
View scanner coverage
The Scanners tab displays scanner coverage across all projects in a group.
To view scanner coverage:
- In the top bar, select Search or go to and find your group.
- In the left sidebar, select Secure > Security configuration.
- Select the Scanners tab.
The tab displays the following cards:
| Card | Description |
|---|---|
| Unprotected projects | List of projects with no scanners enabled. |
| Scanners enabled | Count of all scanner types enabled in the group. |
| Needs attention | List of projects with scan failures. |
| Stale scans | List of projects with a scanner missing from at least three consecutive default branch pipelines. |
Below the cards, a list of each scanner type indicates how many projects have the scanner active, failed, or not configured.
View scanner details
To view the status of a scanner across the projects in the group:
- In the top bar, select Search or go to and find your group.
- In the left sidebar, select Secure > Security configuration.
- Select the Scanners tab.
- Next to the scanner, select View details.
The scanner details page shows stat cards for the scanner (Enabled, Not enabled, Needs attention, and Stale) and a table of every project in the group.
The table shows the following columns:
| Column | Description |
|---|---|
| Project | Project name and path. |
| Source | If available, the name of the applied configuration profile. |
| Status | Current scanner status for the project. |
| Last scan | Time of the most recent scan. |
| Security attributes | Security attributes assigned to the project. Shown only if you can read security attributes. |
Configure a scanner for projects
You can configure scanners that use profile-based configuration. To configure scanners from other sources, such as security policies or CI/CD configuration, you must adjust them at their origin.
To configure a scanner for a project:
-
In the top bar, select Search or go to and find your group.
-
In the left sidebar, select Secure > Security configuration.
-
Select the Scanners tab.
-
Next to the scanner, select View details.
-
Next to a project select the vertical ellipsis ( ), then select an action:
- Enable profile-based scanning: Applies the default profile to the project. Available when the project shows No profile applied.
- Disable profile-based scanning: Removes the applied profile from the project.
- View project configuration: Opens the security configuration page for the project.
- Troubleshoot failure: Provides more details if the most recent scan failed or has a warning.
Use the Scanner Enablement Wizard
The Scanner Enablement Wizard provides two approaches:
- Quick setup: Applies profiles to the projects in the group that match the mode you select. The GitLab default profiles are preselected, and you can change the profile for each scanner.
- Advanced setup: Applies selected profiles to specific projects and scanners.
The wizard does not configure DAST, container scanning, or IaC scanning. Configure these scanners through security policies or at the project level.
Quick setup
The availability of this feature is controlled by a feature flag. For more information, see the history.
Use Quick setup to apply profiles to the entire group, based on the mode you select.
To use Quick setup:
-
In the top bar, select Search or go to and find your group.
-
In the left sidebar, select Secure > Security configuration.
-
Select the Scanners tab.
-
Select Enable scanners.
-
Select Quick setup, then select Start quick setup.
-
On the Select mode step, select which projects get the profiles:
- All projects: Applies the profile to every project. Replaces any profile a project already has for that scanner. Projects that also scan another way, such as with CI/CD configuration or a security policy, run both scans.
- Projects that don't scan yet: Applies the profile only to projects that have no profile and no scan for that scanner. Projects that already scan keep their current setup. This mode is selected by default.
- Replace existing: Applies the profile only to projects that already have a profile for that scanner, and replaces that profile. Other projects are not changed.
GitLab checks each scanner separately. For example, with Projects that don't scan yet, a project that already runs SAST but not secret detection gets the secret detection profile.
-
Optional. To use a different profile for a scanner, next to Scanners, select Edit scanners ( ). On the Select scanners step, from the Configuration profile dropdown list, select a profile, then select Select mode.
-
On the Review configuration step, review the scanners and the mode.
-
Select Apply configuration.
After you apply a configuration, GitLab applies the profiles to projects in batches, which can take several minutes. The confirmation step lists each scanner, its profile, and the number of items each profile applies to.
Advanced setup
Advanced setup applies only the selected profiles to specific projects and scanners. If you need to apply profiles to more than 100 projects at once, use Quick setup.
- In the top bar, select Search or go to and find your group.
- In the left sidebar, select Secure > Security configuration.
- Select the Scanners tab.
- Select Enable scanners.
- Select Advanced setup, then select Start advanced setup.
- On the Select projects step, select the projects to configure. Use the search and filters to find projects. The Scanner coverage column shows existing coverage. You can select up to 100 items.
- On the Select scanners step, select the scanners to enable. For each scanner, select the configuration profile to apply.
- On the Review configuration step, review the selected projects and scanners. To make changes, next to Items, select Edit project scope ( ), or next to Scanners, select Edit scanners ( ).
- Select Apply configuration.
After you apply a configuration, GitLab applies the profiles to projects in batches, which can take several minutes. The confirmation step lists each scanner, its profile, and the number of items each profile applies to.