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
    • Astro CLI
    • Quickstart
    • CLI reference
      • astro completion
      • astro api
      • astro auth
      • astro config
      • astro context
      • astro dbt
      • astro deploy
      • astro deployment
      • astro dev
        • astro dev bash
        • astro dev build
        • astro dev init
        • astro dev kill
        • astro dev logs
        • astro dev object export
        • astro dev object import
        • astro dev parse
        • astro dev proxy
        • astro dev ps
        • astro dev pytest
        • astro dev restart
        • astro dev run
        • astro dev start
        • astro dev stop
        • astro dev upgrade-test
      • astro ide
      • astro login
      • astro logout
      • astro organization
      • astro otto
      • astro remote
      • astro run
      • astro team
      • astro telemetry
      • astro user create
      • astro version
      • astro workspace

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
  • Usage
  • Options
  • Examples
  • Related commands
CLI referenceastro dev

astro dev object import

Edit this page
Built with
The behavior and format of this command are the same for both Astro and Astro Private Cloud.

Import Airflow variables, connections, and pools from a configuration file to a locally running Airflow environment.

Usage

After starting your local Airflow environment with astro dev start, run:

1astro dev object import

By default, the command imports all variables, connections, and pools from airflow_settings.yaml to your project. You do not need to restart your environment for these changes to take effect.

Options

OptionDescriptionPossible Values
-c,--connectionsImport connections from a given local file“
-p,--poolsImport pools from a given local file“
-s,--settings-fileLocation of the file from which to import Airflow objects. The default file path is ~/.airflow_settings.yaml.Any valid filepath
-v,--variablesImport variables from a given local file“

Examples

1astro dev object import --pools
2# Imports pools from `airflow_settings.yaml` to a locally running Airflow environment
3
4astro dev object import --settings-file="myairflowobjects.yaml"
5# Imports all Airflow objects from `myairflowobjects.yaml` to a locally running Airflow environment

Related commands

  • astro dev object export
  • astro deployment variable create
  • astro deployment variable update