This version of GitHub Enterprise was discontinued on 2021-09-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Enabling the dependency graph and Dependabot alerts on your enterprise account

You can connect your GitHub Enterprise Server instance to GitHub Enterprise Cloud and enable the dependency graph and Dependabot alerts in repositories in your instance.

Enterprise owners who are also owners of the connected GitHub Enterprise Cloud organization or enterprise account can enable the dependency graph and Dependabot alerts on your GitHub Enterprise Server instance.

About alerts for vulnerable dependencies on your GitHub Enterprise Server instance

GitHub identifies vulnerable dependencies in repositories and creates Dependabot alerts on your GitHub Enterprise Server instance, using:

  • Data from the GitHub Advisory Database
  • The dependency graph service

For more information about these features, see "About the dependency graph" and "About alerts for vulnerable dependencies."

About synchronization of data from the GitHub Advisory Database

We add vulnerabilities to the GitHub Advisory Database from the following sources:

You can connect your GitHub Enterprise Server instance to GitHub.com with GitHub Connect. Once connected, vulnerability data is synced from the GitHub Advisory Database to your instance once every hour. You can also choose to manually sync vulnerability data at any time. No code or information about code from your GitHub Enterprise Server instance is uploaded to GitHub.com.

About generation of Dependabot alerts

If you enable vulnerability detection, when your GitHub Enterprise Server instance receives information about a vulnerability, it identifies repositories in your instance that use the affected version of the dependency and generates Dependabot alerts. You can choose whether or not to notify users automatically about new Dependabot alerts.

Enabling the dependency graph and Dependabot alerts for vulnerable dependencies on your GitHub Enterprise Server instance

Prerequisites

For your GitHub Enterprise Server instance to detect vulnerable dependencies and generate Dependabot alerts:

Enabling the dependency graph

  1. Sign in to your GitHub Enterprise Server instance at http(s)://HOSTNAME/login.

  2. In the administrative shell, enable the dependency graph on your GitHub Enterprise Server instance:

    $ ghe-config app.github.dependency-graph-enabled true

    Note: For more information about enabling access to the administrative shell via SSH, see "Accessing the administrative shell (SSH)."

  3. Apply the configuration.

    $ ghe-config-apply
  4. Return to GitHub Enterprise Server.

Enabling Dependabot alerts

Before enabling Dependabot alerts for your instance, you need to enable the dependency graph. For more information, see above.

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings. "Enterprise settings" in drop-down menu for profile photo on GitHub Enterprise Server

  2. In the enterprise account sidebar, click Settings. Settings tab in the enterprise account sidebar

  3. In the left sidebar, click GitHub Connect. GitHub Connect tab in the business account settings sidebar

  4. Under "Repositories can be scanned for vulnerabilities", select the drop-down menu and click Enabled without notifications. Optionally, to enable alerts with notifications, click Enabled with notifications. Drop-down menu to enable scanning repositories for vulnerabilities

    Tip: We recommend configuring Dependabot alerts without notifications for the first few days to avoid an overload of emails. After a few days, you can enable notifications to receive Dependabot alerts as usual.

Viewing vulnerable dependencies on your GitHub Enterprise Server instance

You can view all vulnerabilities in your GitHub Enterprise Server instance and manually sync vulnerability data from GitHub.com to update the list.

  1. From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page. Rocketship icon for accessing site admin settings
  2. In the left sidebar, click Vulnerabilities. Vulnerabilities tab in the site admin sidebar
  3. To sync vulnerability data, click Sync Vulnerabilities now. Sync vulnerabilities now button