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.

​
Allowlist Astro IDE egress IP addresses

If your Git provider is private, or if it limits access by IP address, allowlist the Astro IDE egress IP addresses in your Git provider. Without this, the Astro IDE can’t clone your repository or push commits to it. Outbound Git traffic from the Astro IDE comes from a set of persistent egress IP addresses. Astronomer publishes these addresses as the DNS A records of egress.astronomer.io. To get the current list, resolve the domain:
Add every address that the command returns to the allowlist in your Git provider.
These egress IP addresses apply only to Astro IDE Git traffic. They’re separate from the external IP addresses of your Astro clusters and Deployments, which control how a Deployment connects to external services. See Find Deployment external IP addresses. An allowlist entry for one set doesn’t cover the other.
These egress IP addresses are persistent. If Astronomer must change them, Astronomer contacts customers before the change.

​
Import a Git project

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

​
Prerequisites

​
Import your project

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.

​
Open your project in a new session

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.