Port Forward Airflow

Port-forward the airflow-api-server service from Kubernetes to access the Airflow 3.x UI locally.

2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/datasurface/demo1 --skill port-forward-airflow-datasurface
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Port Forward Airflow
Source: https://github.com/datasurface/demo1/tree/main/.claude/skills/port-forward-airflow
Command: npx skills add https://github.com/datasurface/demo1 --skill port-forward-airflow-datasurface

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables developers to access the Airflow 3.x web UI locally by securely port-forwarding the Airflow API server from a Kubernetes cluster to the local machine.

Core Features & Use Cases

  • Local UI access: forward the airflow-api-server service to a reachable localhost port for quick UI inspection and troubleshooting.
  • Flexible port mapping: supports default 8080 or an alternative port when conflicts arise, enabling seamless development workflows.
  • Use Case: you need to monitor DAGs, check UI health, or debug configuration changes without exposing the UI publicly.

Quick Start

kubectl port-forward -n <namespace> svc/airflow-api-server 8080:8080 Access http://localhost:8080 If 8080 is in use, run: kubectl port-forward -n <namespace> svc/airflow-api-server 9090:8080 Access http://localhost:9090

Frequently Asked Questions about Port Forward Airflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I access the Airflow UI locally from a Kubernetes cluster?

You can access the Airflow UI locally by using kubectl to port-forward the airflow-api-server service to your workstation, allowing you to monitor DAGs and verify UI health without public exposure.

What is the command to port-forward the Airflow API server?

The command to port-forward the Airflow API server is `kubectl port-forward -n <namespace> svc/airflow-api-server 8080:8080`, which maps the cluster service to your local machine for UI inspection.

Do I need kubectl to access the Airflow 3.x web UI for debugging?

Yes, you need standard kubectl tooling and access to a Kubernetes cluster running the airflow-api-server to port-forward the service and access the Airflow 3.x web UI for debugging.

What should I do if port 8080 is already in use when port-forwarding Airflow?

If local port 8080 is in use, you can map the Airflow API server to an alternative port like 9090 using `kubectl port-forward -n <namespace> svc/airflow-api-server 9090:8080` and access it at localhost:9090.

Can I use kubectl port-forward to check Airflow configuration changes on a remote cluster?

Yes, you can securely port-forward the airflow-api-server from a remote Kubernetes cluster to your local machine, enabling quick UI verification and health checks for configuration changes.

When should I not use kubectl port-forward for Airflow UI access?

You should avoid using kubectl port-forward for Airflow UI access when you need to expose the web interface publicly or require a permanent ingress route, as port-forwarding is intended for temporary development and debugging workflows.