Skip to main content
PreviewThis feature is in Preview.
Import an existing Git-based project from your preferred provider into the Astro IDE.
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.

​
Import a Git project

To import a GitHub project using the Astro GitHub integration, see the GitHub import guide.

​
Prerequisites

  • Workspace Author 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.
1

Open the Astro IDE

From the Astro UI, select Astro IDE.
2

Open the Projects tab

Click Projects to open the Projects tab.
3

Add a project

Click + Add Project, then select Import Git Project from the dropdown menu.
4

Configure manual Git provider connection

  • Select your Git provider: GitHub, GitLab, Bitbucket, Azure Repos, or Generic.
If you use self-hosted GitHub Enterprise Server, select Generic instead of GitHub. The GitHub option is only for GitHub.com (cloud-hosted) repositories.
  • 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.
5

Complete import

After connecting, the Astro IDE clones your code and prepares the environment. Your imported project appears in the Astro IDE.

​
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 to import one if you haven’t already.
1

Reopen the Astro IDE

From the Astro UI main menu, select Astro IDE.
2

Reopen the Projects tab

Click Projects to open the Projects tab.
3

Select your imported project

Click New Session next to the project you imported to start a new session with that project.
Resume a previous sessionOnce 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.