Skip to main content

How to set up GitHub Enterprise Server

Updated over 2 weeks ago

Accessing source code in GitHub is what allows Foundational to accurately determine data lineage and analyze pending and historical pull requests.

This setup should take about 5 minutes.

Permissions: Any user on GitHub can create the request. Organization owner is required to register the application for the organization.
Repository administrators are required to authorize any repository Foundational needs to access.

  1. Start by clicking on the GitHub Enterprise Server connector in the Connectors page.
    (Do not get confused with the regular GitHub, that one is for the regular public GitHub users)

  2. Fill in the URL, or IP address, of your GitHub Enterprise Server.
    Note: You must make sure that this URL is accessible from Foundational servers. For a list of Foundational IP addresess and how to provide this access, please see: Allowing IP access to Foundational

  3. Click on Configure, you should get redirected to your GitHub Enterprise Server for registering the Foundational app in your organization
    Note: This is not yet installing the app in your org, just registering it

  4. Next, go to the organization settings, and click on Developer Settings
    Note: Make sure you are on the organization settings, and not your user settings. If you are on your user settings, click on Swiitch settings context

  5. Click on GitHub Apps

  6. Click on the Foundational application (it will have the app name you picked in Step 3)

  7. Install the application for the organization
    Note: Install it for the organization, not for your user.

  8. Configure access for Foundational application for all the relevant repositories.

    We generally recommend adding every repository that is owned by the data team, such as dbt, Spark, and airflow.


  9. When done selecting repositories, click on Updated access at the bottom. GitHub repository owners will receive an email from GitHub, asking them to approve foundational-io for their repository.

Did this answer your question?