# GitHub (Destination)

The GitHub Destination credential type stores the Personal Access Token and configuration associated with the GitHub Organization or Enterprise to which you're migrating data with Warp.

To configure a GitHub Destination credential, you'll need:

* A Personal Access Token assigned the [correct scopes](https://kb.packfiles.io/using-warp/warp-vault/supported-credential-providers/get-your-github-credentials), 
* The Organization Slug associated with the token, 
* The days until the token expires, and 
* The GitHub Enterprise Cloud product to which you're migrating. 
  * If you're migrating to GitHub Enterprise Cloud with Data Residency, you'll be prompted to provide the tenant URL associated with your Enterprise.

### Configuration

{% hint style="info" %}
Search for the 🛠️ emoji if you’d like to skim through this content while focusing on the steps you need to follow.
{% endhint %}

### Get the Organization Slug

🛠️ Switch to the browser tab or window containing *Migration HQ.*

Make a note of the URL in your browser’s address bar. The URL contains the *organization slug*, which is the part of the URL that uniquely identifies the organization. It’s the part of the URL after `github.com/` and before `/Migration-HQ`:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FLvmWH9RstsgCrodEOfV3%2F09_Migration_HQ_browser_address_bar.png?alt=media&#x26;token=336f333f-ba77-4dd7-82f6-3ac493112a25" alt="Close-up of the browser&#x27;s address bar, which displays the URL &#x22;github.com/Hypotheticorp01&#x22;." width="375"><figcaption><p>The browser's address bar,<br>while on the <em>Migration HQ</em> page.</p></figcaption></figure>

In this example, the URL for the organization’s page is:

```
github.com/Hypotheticorp01/Migration-HQ
```

The organization slug is the part that comes after `github.com/` and before `/Migration-HQ`, which means that this example’s organization slug is:

```
Hypotheticorp01
```

🛠️ Copy the organization slug from your browser’s address bar and paste it someplace safe — you’ll use it when you create the vault file.

### Generate a Personal Access Token for Your Account&#x20;

🛠️ Switch to the browser tab or window containing *Migration HQ* and click on your profile picture (located near the top right of the page) so that this menu appears:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FDRwaVnKjU7b5dLtzvdk0%2Fimage.png?alt=media&#x26;token=12f326e2-86eb-406a-80a1-078219717e7f" alt="The menu that appears when you click your profile picture. The key item in the menu is the &#x22;Settings&#x22; item." width="173"><figcaption><p>The menu that appears when you<br>click your profile picture.</p></figcaption></figure>

🛠️ Select **Settings** from the menu.

You will be taken to the *Settings* page for your GitHub account:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2Fap5PlO4w6uZZ5UjN7GYm%2F10_GitHub_account_settings_page.png?alt=media&#x26;token=df5332b9-3ced-4258-a960-14a3e3c93bda" alt="The &#x22;Settings&#x22; page for the user&#x27;s GitHub account."><figcaption><p>GitHub account <em>Settings</em> page.</p></figcaption></figure>

🛠️ Scroll down the page until you see the **Developer settings** item appear in the list on the left side:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2F3pR0JtMXI0ltrRmOcN6W%2F11_Developer_setting_spage_scrolled_down.png?alt=media&#x26;token=2790cdb9-7250-4ba2-adfb-36e1aec24e79" alt="The &#x22;Settings&#x22; page for the user&#x27;s GitHub account, scrolled farther down the page. The key item is the “Developer settings” item at the bottom of the left-side menu."><figcaption><p>GitHub account <em>Settings</em> page, scrolled farther down.</p></figcaption></figure>

🛠️ Click on **Developer settings**.

This will take you to the *Developer Settings* page:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FMwgDutcofkQ7QDh1MKXN%2F12a%20Developer_settings_1.png?alt=media&#x26;token=fbf36d79-7f5c-4d52-9af5-1f8cabc98e77" alt="The &#x22;Developer Settings&#x22; page. The key item is the “Personal access tokens” item at the bottom of the left-side menu."><figcaption><p>The <em>Developer Settings</em> page.</p></figcaption></figure>

🛠️ In the menu on the left side of the page, expand the **Personal access tokens** item:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FMvTfdVCIle5MZPIrVMo3%2F13a%20Personal%20access%20tokens%20menu.png?alt=media&#x26;token=a738dbfb-3d9a-4a6a-a0ff-6c7ed55022dc" alt="The Personal access tokens menu. The key item is the “Tokens (classic)” menu item." width="311"><figcaption><p>The <em>Personal access tokens</em> menu.</p></figcaption></figure>

&#x20;🛠️ Select **Tokens (classic)** from the menu.

You will end up at the *Personal access tokens (classic)* page:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FgjPmFLru0QEVofqko5eG%2F14a%20Personal%20access%20tokens%20page.png?alt=media&#x26;token=5c39c006-099b-47bb-8483-a3ead0628e2d" alt="The Personal access tokens (classic) page. The key item is the “Generate new token” button."><figcaption><p>The <em>Personal access tokens (classic)</em> page.</p></figcaption></figure>

Towards the top right of the page, you’ll see the **Generate new token** button.

🛠️ Click the **Generate new token** button to make its menu appear:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2F7pXFyiJaCCZaCZ9rSFjO%2Fimage.png?alt=media&#x26;token=2f8d338a-851c-4ae8-84f7-e509975cb437" alt="The Generate new token button&#x27;s menu. The key item is the “Generate new token (classic)” menu item." width="375"><figcaption><p>The <em>Generate new token</em> menu.</p></figcaption></figure>

🛠️ ...then select **Generate new token (classic)** from the menu.

You will arrive at the *New personal access token (classic)* page, where you’ll need to provide enough information to create a new personal access token:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FtCWvhv5zfxnLsvnV8LhZ%2F15_New_personal_access_token_form.png?alt=media&#x26;token=f7f8a348-d1fe-407d-a2ae-acbb2bae8684" alt="The “New personal access token (classic)” page."><figcaption><p>The <em>New personal access token (classic)</em> page.</p></figcaption></figure>

🛠️ Enter a name or some other text to help you identify the token in the **Note** field. To make it easier to identify, we suggest you include “Warp” in the name:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FzzovUCdLSMBApjvVyrNJ%2F16a%20Note%20and%20expiration.png?alt=media&#x26;token=cc1888af-148a-4f64-be86-566b757edae8" alt="The “Note” field and “Expiration” drop-down menu. The “Note” field contains the text “Warp migration 1” and the “Expiration” drop-down menu has “30 days” selected." width="375"><figcaption><p>The <em>Note</em> field and <em>Expiration</em> drop-down menu.</p></figcaption></figure>

{% hint style="info" %}
For the purposes of this Quickstart, we’ll leave the **Expiration** field at the default value of 30 days.
{% endhint %}

🛠️ Under **Select scopes**, check the following boxes. Checking these boxes will automatically check their sub-boxes:

* **repo**
* **workflow**
* **write:packages**
* **delete:packages**
* **admin:org**

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FheW1ZRl4kUiyGbVhlKvZ%2F17_scopes_1.png?alt=media&#x26;token=dfc80b85-7526-4e05-871d-4d374980bf8a" alt="The first section of the checkboxes on the “New personal access token (classic)” page, with the “repo”, “workflow”, “write:packages”, “delete:packages”, and “admin:org” checkboxes checked."><figcaption><p>The first set of checkboxes.</p></figcaption></figure>

🛠️  Then scroll down the page and check these boxes. Once again, checking these boxes will automatically check their sub-boxes:

* **admin:repo\_hook**
* **admin:org\_hook**
* **delete\_repo**

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FhBxdQit46mfuQxWQbHcu%2Fimage.png?alt=media&#x26;token=e8f4d07b-2752-4ee6-a37f-f346c46ea8f6" alt="The next section of the checkboxes on the “New personal access token (classic)” page, with the “admin:repo_hook”, “admin:org_hook”, and “delete_repo” checkboxes checked."><figcaption><p>The next set of checkboxes.</p></figcaption></figure>

Feel free to use the checklist below to double-check that you’ve checked all the necessary checkboxes. It’s important to make sure you’ve checked all of them!

* [ ] **repo**
* [ ] **workflow**
* [ ] **write:packages**
* [ ] **delete:packages**
* [ ] **admin:org**
* [ ] **admin:repo\_hook**
* [ ] **admin:org\_hook**
* [ ] **delete\_repo**

🛠️ Scroll to the bottom of the page and click the **Generate token** button:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FvyholX10QnTH1FhfwbLL%2Fimage.png?alt=media&#x26;token=f4f3e755-2309-480f-a7ff-533667ec9ad8" alt="The &#x22;Generate token&#x22; button." width="162"><figcaption></figcaption></figure>

You should now see this page, which will display the personal access token you just created:

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2F6uxKL01BG9T15ORhb1kE%2Fimage.png?alt=media&#x26;token=7f1073fc-40cb-4aee-a100-3d5e7c6ac008" alt="The Personal access tokens (classic) page, with the newly-created Personal Access Token."><figcaption><p>The <em>Personal access tokens (classic)</em> page, with the newly-created Personal Access Token.</p></figcaption></figure>

🛠️ Copy the token and **save it in a safe place** — preferably a password manager.

{% hint style="warning" %}
This will be the only time that this Personal Access Token will be presented to you.&#x20;

Make sure you’ve copied it someplace safe before clicking the **Close** button!
{% endhint %}

{% hint style="info" %}
Depending on your GitHub organization settings, you may also need to authorize your personal access token you issued for your Vault with SSO as well.

Visit <https://github.com/settings/tokens> and examine the `Configure SSO`dropdown menu adjacent to your personal access token.

<details>

<summary>View screenshot</summary>

<figure><img src="https://2589376588-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOe1Y56Oetn6ATqblYj2K%2Fuploads%2FxDVUIhIH2A6oxi6y3fzw%2Fpackfiles_pat_sso.png?alt=media&#x26;token=6b77331b-ce66-48aa-8800-498e915976d8" alt=""><figcaption><p>Personal Access Token SSO Config Menu</p></figcaption></figure>

</details>

If you receive an error like the following`Resource protected by organization SAML enforcement. You must grant your OAuth token access to this organization.` in the terminal or in a runner log, then review your Personal Access Token SSO authorizations as seen above.&#x20;
{% endhint %}