Skip to main content

Configuring Dependabot security updates

You can use Dependabot security updates or manual pull requests to easily update vulnerable dependencies.

About configuring Dependabot security updates

You can enable Dependabot security updates for any repository that uses Dependabot alerts and the dependency graph. For more information, see "About Dependabot security updates."

You can disable Dependabot security updates for an individual repository or for all repositories owned by your personal account or organization. For more information, see "Managing Dependabot security updates for your repositories" below.

Dependabot and all related features are covered by GitHub's Terms of Service.

Supported repositories

GitHub automatically enables Dependabot security updates for every repository that meets these prerequisites.

Note: You can manually enable Dependabot security updates, even if the repository doesn't meet some of the prerequisites below. For example, you can enable Dependabot security updates on a fork, or for a package manager that isn't directly supported by following the instructions in "Managing Dependabot security updates for your repositories."

Automatic enablement prerequisiteMore information
Repository is not a fork"About forks"
Repository is not archived"Archiving repositories"
Repository is public, or repository is private and you have enabled read-only analysis by GitHub, dependency graph, and vulnerability alerts in the repository's settings"Managing data use settings for your private repository."
Repository contains dependency manifest file from a package ecosystem that GitHub supports"Supported package ecosystems"
Dependabot security updates are not disabled for the repository"Managing Dependabot security updates for your repository"

If security updates are not enabled for your repository and you don't know why, first try enabling them using the instructions given in the procedural sections below. If security updates are still not working, you can contact GitHub Support.

Managing Dependabot security updates for your repositories

You can enable or disable Dependabot security updates for an individual repository (see below).

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

Dependabot security updates require specific repository settings. For more information, see "Supported repositories."

Enabling or disabling Dependabot security updates for an individual repository

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

  2. Under your repository name, click Settings. Repository settings button

  3. In the "Security" section of the sidebar, click Code security and analysis.

  4. Under "Code security and analysis", to the right of "Dependabot security 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. "Code security and analysis" section with button to enable Dependabot security updates

Overriding the default behavior with a configuration file

You can override the default behavior of Dependabot security updates by adding a dependabot.yml file to your repository. For more information, see "Configuration options for the dependabot.yml file."

If you only require security updates and want to exclude version updates, you can set open-pull-request-limit to 0 in order to prevent version updates for a given package-ecosystem. For more information, see "open-pull-request-limit."

# Example configuration file that:
#  - Ignores lodash dependency
#  - Disables version-updates

version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "daily"
    ignore:
      - dependency-name: "lodash"
        # For Lodash, ignore all updates
    # Disable version updates for npm dependencies
    open-pull-requests-limit: 0

For more information about the configuration options available for security updates, see the table in "Configuration options for the dependabot.yml file."

Further reading