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

# Create and Configure Your Project

> Create a new Project, install Warp’s GitHub App, and configure the Project.

### Objective

In Warp, a **Project** is an object for managing the migration of repositories to GitHub. Typically, you’ll create a new project for a specific *migration engagement*, such as moving a collection of repositories for an organization, department, team, or development project.

In this section, you’ll set up a Project by creating it, installing the Warp GitHub app for the organization, and configuring the Project.

**At the end of this section, you will have a new Warp project.**

<Info>
  Search for the 🛠️ emoji if you’d like to skim through this content while focusing on the steps you need to follow.
</Info>

### Sign In to the Warp Web Application

🛠️ Open a browser tab or window to the [Warp web application](https://warp.packfiles.io) at [warp.packfiles.io](https://warp.packfiles.io)

<Frame caption="Warp's Login Page">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(122).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=dd4217fde6fc1a660e2a96764cc04b5f" alt="" width="563" data-path="content/media/images/image (122).png" />
</Frame>

🛠️ Click the **Sign in with GitHub** button and sign in to Warp using your GitHub account.

### Create a New Project

Upon signing in, you will be taken to Warp’s *Projects* page, which lists your current migration projects:

<Frame caption="Warp’s *Projects* page, which you’ll see immediately after signing in.">
  <img src="https://mintcdn.com/packfiles/2Rig8FdmZRZViVPt/content/media/images/projects%20page%201.png?fit=max&auto=format&n=2Rig8FdmZRZViVPt&q=85&s=5618b03eac3ba821ea9b7aa55734c9dd" alt="Warp's &#x22;Projects&#x22; page, with a single project and the &#x22;Create a New Project&#x22; area." width="1600" height="800" data-path="content/media/images/projects page 1.png" />
</Frame>

At the bottom of the list of projects, you’ll see the **Create a New Project** area.

🛠️ Click anywhere on **Create a New Project** area to expand it.

The **Create a New Project** area will expand to display instructions for what to do next:

<Frame caption="The *Create a New Project* area, after you’ve expanded it.">
  <img src="https://mintcdn.com/packfiles/2Rig8FdmZRZViVPt/content/media/images/image%20(74).png?fit=max&auto=format&n=2Rig8FdmZRZViVPt&q=85&s=b93a0ec3462594e81b20c5439f70f3d1" alt="Close-up of the expanded &#x22;Create a New Project&#x22; area, with the steps for creating a new project and the &#x22;Install Warp from the GitHub Marketplace&#x22; button." width="2736" height="614" data-path="content/media/images/image (74).png" />
</Frame>

🛠️ Click the **Install Warp from the GitHub Marketplace** button.

### Install Warp’s Github App

A new browser will open to the [GitHub Marketplace page for Warp’s GitHub app](https://github.com/marketplace/packfiles-warp):

<Frame caption="The Warp app’s page in GitHub Marketplace.">
  <img src="https://mintcdn.com/packfiles/2Rig8FdmZRZViVPt/content/media/images/image%20(8)%20(1).png?fit=max&auto=format&n=2Rig8FdmZRZViVPt&q=85&s=6bfef5ebf003a420a6fe2d613870e690" alt="The top of the Warp app's page in GitHub Marketplace. The &#x22;Add&#x22; button is near the upper right corner of the page." width="1582" height="766" data-path="content/media/images/image (8) (1).png" />
</Frame>

🛠️ Click the **Add** button near the upper right corner of the page or scroll to the bottom of the page. You should see the following:

<Frame caption="The Warp app’s page in GitHub Marketplace, scrolled to the bottom.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/image%20(1)%20(1)%20(1)%20(1).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=062db934fa03570273b9dae568105657" alt="The bottom of the Warp app's page in GitHub. The &#x22;Account&#x22; and &#x22;Install it for free&#x22; buttons button is near the bottom of the page." width="1583" height="711" data-path="content/media/images/image (1) (1) (1) (1).png" />
</Frame>

At the bottom of the page, you’ll see the **Account** drop-down menu and the **Install it for free** button:

<Frame>
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/02a%20-%20Review%20your%20order.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=cc9f9eeb6f18dd15ef3c49c680694fe3" alt="Close-up of the &#x22;Account&#x22; drop-down menu and &#x22;Install it for free&#x22; button." width="341" data-path="content/media/images/02a - Review your order.png" />
</Frame>

🛠️ In the **Account** menu, select the account for the destination organization — that is, the organization that you will be migrating repositories to.

<Info>
  The example destination organization for this quickstart is **Hypotheticorp01**.
</Info>

🛠️ Click the **Install it for free** button.

You’ll be taken to the **Review Your Order** page:

<Frame caption="The *Review Your Order* page in GitHub Marketplace.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/02a%20-%20Review%20your%20order%20(2).png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=72c6606317667fa3c3c371cd04f0f3f2" alt="The &#x22;Review your order&#x22; page in GitHub Marketplace. It shows that the user is getting Warp for free, and that the version supports 1 user, 10 repositories, and migrates from Azure DevOps to GHEC." width="2100" height="1435" data-path="content/media/images/02a - Review your order (2).png" />
</Frame>

🛠️ Review the order, then click the **Complete order** button.

You’ll go to the *Install Packfiles Warp* page, which will show:

* That the Warp GitHub app will have access to all the repositories in the organization, and
* What read, read/write, and admin permissions it will have within the organization and its repositories.

<Frame caption="The *Install Packfiles Warp* page in GitHub.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/03a%20-%20Install%20Packfiles%20Warp.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=9773527c7ba09be2351782049ac7edb9" alt="The &#x22;Install Packfiles Warp&#x22; page on GitHub. It shows that Warp will be included for the user's organization for all repositories, with a long list of permissions." width="375" data-path="content/media/images/03a - Install Packfiles Warp.png" />
</Frame>

🛠️ Click the **Install** button at the bottom of the page.

You will return to the Warp web app, and can proceed to the next step.

### Configure the Project

You will be at the *Welcome to Warp* page:

<Frame caption="The *Welcome to Warp* page.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/04a%20-%20Welcome%20to%20Warp.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=21422bcc7318aea943e4f3b9e0602c18" alt="The &#x22;Welcome to Warp&#x22; page in the Warp web app. Key items are the user's destination organization and the &#x22;Next&#x22; button." width="3808" height="1226" data-path="content/media/images/04a - Welcome to Warp.png" />
</Frame>

🛠️ Click the **Next** button.

This will take to you the *Configure Your Project* page:

<Frame caption="The *Configure Your Project* page.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/05a%20Configure%20your%20project.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=e590f6dcd500e994d8864f2d07c647ec" alt="The &#x22;Configure Your Project&#x22; page in the Warp web app. Key items are the user's project name and the &#x22;Next&#x22; button." width="3808" height="1447" data-path="content/media/images/05a Configure your project.png" />
</Frame>

You can do two things on this page:

1. You can set the name of your project, or choose to keep the default name.
2. You can invite people on your team to become members of the project.

<Info>
  As the creator of the project, you don’t have to add yourself to the team. You are already a member of the project with *Admin* access.
</Info>

🛠️ For this Quickstart, simply click the **Next** button.

You will arrive at the *Connect Your Sources* page. You’ll use it in the process of connecting your source and GitHub accounts to Warp:

<Frame caption="The *Connect Your Sources* page.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/06a%20Connect%20Your%20Sources.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=16b929c46a92c896e83a0b88e2fbc295" alt="The &#x22;Connect Your Sources&#x22; page in the Warp web app. Key items are the user's project name and the &#x22;Next&#x22; button. The key item on this page is the “Migration HQ” button." width="3808" height="1722" data-path="content/media/images/06a Connect Your Sources.png" />
</Frame>

When you created the project, Warp created a repository named *Migration HQ* for the GitHub organization that you selected earlier. *Migration HQ* will be the user interface for managing your migrations. It will be where you issue commands to Warp and it will keep track of which repositories to migrate and which ones have already been migrated.

🛠️ Let’s visit *Migration HQ*. Click the **Migration HQ** button, located in the *Set Up Your Vault* section:

<Frame>
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/07a%20Migration%20HQ.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=d93357e7472c0980fdb85bf7d4794a8c" alt="The &#x22;Migration HQ&#x22; button." width="179" data-path="content/media/images/07a Migration HQ.png" />
</Frame>

A new browser tab or window will open, and you should see the *Migration HQ* page:

<Frame caption="The *Migration HQ* page for your project.">
  <img src="https://mintcdn.com/packfiles/l0V83cTRF3ti5K9q/content/media/images/08_-_Migration_HQ.png?fit=max&auto=format&n=l0V83cTRF3ti5K9q&q=85&s=06c14ee88d22b8bf1ebbd89fb319d5e3" alt="The &#x22;Code&#x22; page of the &#x22;Migration HQ&#x22; repository in GitHub." width="3808" height="1818" data-path="content/media/images/08_-_Migration_HQ.png" />
</Frame>

The files contained in *Migration HQ* are configuration and credentials files that Warp will use in the migration process. You will need to clone *Migration HQ* to your local computer, where you will create a *vault file* containing the following:

* Credentials for accessing the repositories at the source (the place where you are migrating repositories *from*).
* Credentials for accessing the destination GitHub organization (the place where you are migrating repositories *to*).

After creating the vault file, Warp will automatically push it to *Migration HQ*, making the credentials available to Warp, enabling it to migrate your repositories.

🛠️ Clone the *Migration HQ* repository to your local computer.

<Success>
  You’ve successfully set up your project — nicely done!

  Make sure that you’ve cloned *Migration HQ* to your local computer, then [proceed to the next step.](set-up-your-vault)
</Success>
