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
      • Upgrade Astronomer
      • Apply a config change
        • Use a registry backend
        • Configure namespace pools
        • Configure platform resources
        • Configure component size limits
        • Add Pod labels
        • Overprovision Deployments
    • 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
  • Prerequisites
  • Configure Pod labels
  • Find labeled Pods
  • Related links
AdministrationManage platform resources

Add labels to Pods created by the Astronomer Helm chart

Edit this page
Built with

If your organization enforces Pod labeling for security, workload identity, multi-tenancy, or policy enforcement, you can configure Astronomer Software to automatically add labels to all Pods it creates during installation or upgrades.

Prerequisites

  • You must have System Admin permissions to perform an upgrade or installation.

Configure Pod labels

In your Helm chart, add the podLabels configuration to the values.yaml file during your update or installation process.

1global:
2 podLabels:
3 key: "value"

For example, you can use the label security.level: "high" as a way to identify Pods created by Software using the following code:

1global:
2 podLabels:
3 security.level: "high"

Find labeled Pods

You can search for Pods using the kubectl command get pods with the label flag. For example, to retrieve a list of all Pods labeled with the key-value pair, security.level=high, you can use the following command:

$kubectl -n astronomer get pods -l security.level=high

Related links

  • Upgrade Software
  • Install Astronomer Software