---
title: "(Beta) GitHub Integration"
slug: "github"
description: "Learn how to integrate Traceable’s GitHub App to run code scans, manage repository access, and surface security insights directly in your CI/CD pipeline."
tags: ["Code Scans", "GitHub Integration"]
updated: 2025-12-10T07:08:28Z
published: 2025-12-10T07:08:28Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://traceabledocs.document360.io/llms.txt
> Use this file to discover all available pages before exploring further.

# (Beta) GitHub Integration

# 

Traceable's GitHub App allows you to run code scans against repositories in your GitHub organization with ease. This integration enables you to monitor code risks directly within your CI/CD pipeline, surfacing repository metadata and scan results in the Traceable dashboard.

## What will you learn in this topic?

By the end of this topic, you will be able to:

- Understand the prerequisites for the GitHub App integration.
- Understand the steps to add a new GitHub with Traceable.

---

## Before You Begin

Make a note of the following before integrating GitHub actions with Traceable:

- You have administrative access to your GitHub organization (or the ability to request app installation).
- You are logged into your Traceable account.
- You know which repositories you want to scan.

---

## Configure the GitHub App Integration

To configure the GitHub app in Traceable, complete the following steps:

### Step 1 — Navigate to CI/CD Integrations

On the **All Integrations** page, navigate to **CI/CD** Integrations, and search *GitHub* in the search bar. You can click the **Configure** button on the**GitHub** tile.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/inte_navigation.gif)

## 

### Step 2 — Choose Traceable’s GitHub App

In the **Add New GitHub Integration**slide-out window, select Traceable's GitHub App from the dropdown, and ensure that **Save** is enabled.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/running_code_scan_traceable_github-image-b1tsphq5 (1).png)

### Step 3 — Authorize the App in GitHub

You will be redirected to GitHub to complete the app installation. Confirm the action in the GitHub pop-up by clicking **Yes, Configure**.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/yes.png)

### Step 4 — Choose Your GitHub Organization

In GitHub, select the organization where you want to install the app.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/running_code_scan_traceable_github-image-1m3adzl8.png)

### Step 5 — Select Repositories

Choose the repositories you want the Traceable GitHub App to access.

- These repositories will be listed under **Discovery →** **Inventory → Repositories**in the Traceable dashboard.
- You can modify repository selection later.
- If you do not have admin access, you will be prompted to send a request to an organization administrator.

Click **Install & Authorize**.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/running_code_scan_traceable_github-image-deufasf8.png)

### Step 6 — Confirm Integration in Traceable

After authorization, you will return to Traceable. You should now see a GitHub tile under the **Configured CI/CD Integrations**section. You can reconfigure the app at any time from here.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/saved_integrartion_github(1).png)

---

### Viewing Repositories and Initiating a Code Scan

### 

To view the repositories, navigate to **Discovery → Inventory → Repositories**. You should now see the repositories you selected during setup.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/repo.png)

### 

Select any repository from the list and click **Trigger Scan**to initiate a code scan.

![](https://cdn.document360.io/24f14f07-13d1-4684-8fae-6d8f811768ee/Images/Documentation/trigger_scan.png)

## Related

- [(Beta) API discovery from code](/api-discovery-from-code.md)