For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Overview
      • Overview
        • Overview
        • Quickstart
          • Import a CLI project
          • Import project with Astro GitHub integration
          • Import a Git project
        • Author dags
        • Blueprint
        • Test and run dags
      • Dag versioning
      • Airflow logs
      • DAG and task runs
      • Airflow REST API
    • Book Office Hours

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
On this page
  • Import a Git project
  • Prerequisites
  • Start a new session with your imported project
  • Prerequisites
Develop DAGsAstro IDEImport projects

Import a Git project to the Astro IDE

Edit this page
Built with
Preview
This 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 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.