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

# Import a Git project to the Astro IDE

<Info>
  **Preview**

  This feature is in [Preview](/docs/astro/feature-previews).
</Info>

Import an existing Git-based project from your preferred provider into the Astro IDE.

<Warning>
  You can't deploy code directly to an Astro Deployment from projects imported with a manual Git provider configuration.
  To deploy, commit and push your changes back to your Git provider, then trigger your usual CI/CD deployment process.
  Direct deploy from the IDE is only supported for projects imported with the Astro GitHub integration, the Astro CLI, or projects created in the IDE. See [Deploy code from the Astro IDE](/docs/astro/ide-deploy).
</Warning>

## Import a Git project

<Info>
  To import a GitHub project using the Astro GitHub integration, see the [GitHub import guide](/docs/astro/ide-import-github-project).
</Info>

### Prerequisites

* [Workspace Author](/docs/astro/user-permissions) permissions.
* A remote Git repository containing an Astro project.
* Access permissions to the repository.
* Project size under 200 MB and individual file sizes under 1 MB. See [Project requirements](/docs/astro/ide-overview#project-requirements).

<Steps>
  <Step title="Open the Astro IDE">
    From the Astro UI, select **Astro IDE**.
  </Step>

  <Step title="Open the Projects tab">
    Click **Projects** to open the **Projects** tab.
  </Step>

  <Step title="Add a project">
    Click **+ Add Project**, then select **Import Git Project** from the dropdown menu.
  </Step>

  <Step title="Configure manual Git provider connection">
    * Select your Git provider: **GitHub**, **GitLab**, **Bitbucket**, **Azure Repos**, or **Generic**.

    <Info>
      If you use self-hosted GitHub Enterprise Server, select **Generic** instead of **GitHub**. The **GitHub** option is only for GitHub.com (cloud-hosted) repositories.
    </Info>

    * Fill in the following fields:
      * **Account**: The organization or user as shown in the provider URL.
      * **Repository/Project**: The repository or project name.
      * **Astro Project Path**: The subdirectory where your Astro project is located, if not at repository root.
      * **Branch**: The branch to use. Defaults to the provider's default branch.

    * Select authentication type. Available authentication types may differ slightly for each Git provider:
      * **Basic**
      * **Personal access token**
      * **Deploy key or Personal SSH key**
      * **None (public repository)**: Select if you are connecting to a public repository that doesn't require authentication. You can't push changes to the remote repository without authentication.

    Click **Connect** to begin importing.
  </Step>

  <Step title="Complete import">
    After connecting, the Astro IDE clones your code and prepares the environment.
    Your imported project appears in the Astro IDE.
  </Step>
</Steps>

## Start a new session with your imported project

After importing your project, you can start a new session with it.

### Prerequisites

* An imported project in the Astro IDE. See [Import a Git project](#import-a-git-project) to import one if you haven't already.

<Steps>
  <Step title="Reopen the Astro IDE">
    From the Astro UI main menu, select **Astro IDE**.
  </Step>

  <Step title="Reopen the Projects tab">
    Click **Projects** to open the Projects tab.
  </Step>

  <Step title="Select your imported project">
    Click **New Session** next to the project you imported to start a new session with that project.
  </Step>
</Steps>

<Tip>
  **Resume a previous session**

  Once you have created a session with your imported project, you can close it, and later resume it. In the Astro IDE, go to the **Sessions** tab, and click the session you want to resume.
</Tip>