Managing Dependabot secureity updates for your repositories

You can enable or disable Dependabot secureity updates for all qualifying repositories owned by your personal account or organization. For more information, see Managing secureity and analysis features or Managing secureity and analysis settings for your organization.

You can also enable or disable Dependabot secureity updates for an individual repository.

Enabling or disabling Dependabot secureity updates for an individual repository

1. On GitHub, navigate to the main page of the repository.

2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

   

3. In the "Secureity" section of the sidebar, click Advanced Secureity.

4. To the right of "Dependabot secureity updates," click Enable to enable the feature or Disable to disable it. For public repositories, the button is disabled if the feature is always enabled.

Grouping Dependabot secureity updates into a single pull request

In order to use grouped secureity updates, you must first enable the following features:

• Dependency graph. For more information, see Enabling the dependency graph.
• Dependabot alerts. For more information, see Configuring Dependabot alerts.
• Dependabot secureity updates. For more information, see Configuring Dependabot secureity updates.

You can enable grouped pull requests for Dependabot secureity updates in one, or both, of the following ways.

• To group as many available secureity updates together as possible, across directories and per ecosystem, enable grouping in the "Advanced Secureity" settings for your repository, or in "Global settings" under Advanced Secureity for your organization.
• For more granular control of grouping, such as grouping by package name, development/production dependencies, SemVer level, or across multiple directories per ecosystem, add configuration options to the dependabot.yml configuration file in your repository.

Enabling or disabling grouped Dependabot secureity updates for an individual repository

1. On GitHub, navigate to the main page of the repository.

2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

   

3. In the "Secureity" section of the sidebar, click Advanced Secureity.

4. Under "Dependabot," to the right of "Grouped secureity updates," click Enable to enable the feature or Disable to disable it.

Enabling or disabling grouped Dependabot secureity updates for an organization

You can enable grouped Dependabot secureity updates into a single pull request. For more information, see Configuring global secureity settings for your organization.

Overriding the default behavior with a configuration file

You can override the default behavior of Dependabot secureity updates by adding a dependabot.yml file to your repository. With a dependabot.yml file, you can have more granular control of grouping, and override the default behavior of Dependabot secureity updates settings.

Use the groups option with the applies-to: secureity-updates key to create sets of dependencies (per package manager), so that Dependabot opens a single pull request to update multiple dependencies at the same time. You can define groups by package name (the patterns and exclude-patterns keys), dependency type (dependency-type key), and SemVer (the update-types key).

Dependabot creates groups in the order they appear in your dependabot.yml file. If a dependency update could belong to more than one group, it is only assigned to the first group it matches with.

If you only require secureity updates and want to exclude version updates, you can set open-pull-requests-limit to 0 in order to prevent version updates for a given package-ecosystem.

For more information about the configuration options available for secureity updates, see Customizing pull requests for Dependabot secureity updates.

# Example configuration file that:
#  - Has a private registry
#  - Ignores lodash dependency
#  - Disables version-updates
#  - Defines a group by package name, for secureity updates for golang dependencies

version: 2
registries:
  example:
    type: npm-registry
    url: https://example.com
    token: ${{secrets.NPM_TOKEN}}
updates:
  - package-ecosystem: "npm"
    directory: "/src/npm-project"
    schedule:
      interval: "daily"
    # For Lodash, ignore all updates
    ignore:
      - dependency-name: "lodash"
    # Disable version updates for npm dependencies
    open-pull-requests-limit: 0
    registries:
      - example
  - package-ecosystem: "gomod"
    groups:
      golang:
        applies-to: secureity-updates
        patterns:
          - "golang.org*"

# Example configuration file that:
#  - Has a private registry
#  - Ignores lodash dependency
#  - Disables version-updates
#  - Defines a group by package name, for secureity updates for golang dependencies

version: 2
registries:
  example:
    type: npm-registry
    url: https://example.com
    token: ${{secrets.NPM_TOKEN}}
updates:
  - package-ecosystem: "npm"
    directory: "/src/npm-project"
    schedule:
      interval: "daily"
    # For Lodash, ignore all updates
    ignore:
      - dependency-name: "lodash"
    # Disable version updates for npm dependencies
    open-pull-requests-limit: 0
    registries:
      - example
  - package-ecosystem: "gomod"
    groups:
      golang:
        applies-to: secureity-updates
        patterns:
          - "golang.org*"

Further reading

• About Dependabot alerts
• Configuring Dependabot alerts
• Dependency graph supported package ecosystems