Remote Execution Agent release notes
Remote Execution Agent image release cadence
New Remote Execution Agent images are typically released when an Astro Runtime based on a new Airflow version becomes available, or when critical bug or security fixes are required for an existing Runtime or Airflow version.
You can expect the updated Agent image to be published within seven days of the corresponding Runtime image release.
Helm chart now versioned independently from the Remote Execution Agent
As of May 2026, the Remote Execution Agent Helm chart is versioned separately from the Agent, so chart releases no longer appear on this page. Helm chart 2.0.0 introduces a breaking change for upgrades from 1.x that requires action before you run helm upgrade. See Helm chart versioning for the compatibility matrix and upgrade steps.
The Astro Remote Execution Agent allows you to run your Airflow tasks remotely in your Kubernetes cluster, connecting to an existing Astro Deployment. This Agent provides the following components:
- Workers: Execute tasks from specified queues.
- Dag processor: Process and sync Dags from configured sources.
- Triggerer: Handle deferrable operators and triggers.
To upgrade Remote Execution Agent, see Upgrade Remote Execution Agent. For general product release notes, see Astro Release Notes. If you have any questions or a bug to report, contact Astronomer support.
Known issues
The following known issues apply to all current Remote Execution Agent releases:
- The Dag processor supports reading Airflow variables, but you cannot currently create, update, or delete variables from the Dag processor.
Astro Remote Execution Agent and Sentinel 1.8.3
- Release date: July 23, 2026
Additional improvements
- Updated bundled dependencies to address security vulnerabilities in
click.
Images included
See Astro Remote Execution Agent 1.8.3 images included.
Astro Remote Execution Agent and Sentinel 1.8.2
- Release date: July 17, 2026
Additional improvements
- Improved how the worker, Dag processor, and triggerer components communicate with the Astro control plane to better support future Airflow versions.
Bug fixes
- Fixed a bug that could cause an agent component to send an unnecessary internal header on requests to the Astro control plane.
Images included
See Astro Remote Execution Agent 1.8.2 images included.
Astro Remote Execution Agent and Sentinel 1.8.1
- Release date: July 15, 2026
Additional improvements
- Task-level utilization metrics support extends to all supported Remote Execution Agent versions 1.5.0 and later using the Helm 2.0.0+ chart.
Bug fixes
- Fixed a bug introduced in 1.8.0 where Remote Execution Agents on Astro Runtime versions earlier than 3.3, such as Runtime 3.2, failed to start because the agent incorrectly required a worker-side state store backend that those runtimes don’t include. The agent now requires the backend only on Astro Runtime 3.3 and later images.
- Fixed a bug where the local HTTP proxy in the agent could stop forwarding task heartbeats when an unresponsive upstream connection held a connection-pool slot indefinitely. The proxy client now sets explicit timeouts.
Images included
See Astro Remote Execution Agent 1.8.1 images included.
Astro Remote Execution Agent and Sentinel 1.8.0
- Release date: July 15, 2026
Airflow 3.3 support
Agent Client now supports Airflow 3.3 (Astro Runtime 3.3-2), with images for Python 3.12, 3.13, and 3.14. This includes support for the Airflow 3.3 worker-side state store: agents offload task and asset state to a backend that you configure, such as object storage, instead of storing it in the Astro control plane. Asset-watcher triggers running in the agent triggerer can also access the asset state store.
When you run agents on a Runtime 3.3 image, you must configure a state store backend through the AIRFLOW__WORKERS__STATE_STORE_BACKEND environment variable. Agents on Runtime 3.3 images do not start until you set this variable.
Additional improvements
- The Dag processor now caches parsed Dags by default and sends only new and changed Dags on each heartbeat, instead of every serialized Dag. Set
ASTRO_AGENT_CLIENT_DAG_PROCESSOR__ENABLE_DAG_CACHING=falseto opt out. - Agents now detect DNS changes for the Astro control plane and re-create their connections, so they reconnect automatically after a disaster recovery failover instead of requiring a restart.
- New Agent Client releases no longer publish floating image tags, such as
3.2-5or3.2-5-python-3.13. Existing floating tags remain in the registry but no longer receive updates. Use the pinned tags listed in the Remote Execution Agent image reference, as recommended by the Agent maintenance policy. - Where Sentinel is integrated, agent components now report an initializing status while their Pods start up, instead of briefly reporting as unhealthy.
- Reduced Sentinel memory usage by excluding Kubernetes managed fields from the Pod cache.
- The control plane now manages the Sentinel heartbeat interval, as it already does for the heartbeat intervals of other agent components.
- Updated bundled dependencies to address security vulnerabilities in
cryptography,pyjwt,python-multipart, andstarlette.
Bug fixes
- Fixed a bug where the Dag processor on Airflow versions earlier than 3.3 did not respect configured Dag bundle refresh intervals, so bundles could refresh too often or on another bundle’s schedule.
- Fixed a bug where unpausing a Dag that uses asset watchers did not create the watcher triggers with Dag caching enabled. Dags that use asset watchers are now excluded from Dag caching.
- Fixed a bug where Dag-level and task-level callbacks that pull XComs failed with
ForbiddenSessionUseError, which could repeatedly crash the Dag processor on Airflow 3.1. The Dag processor now serves callback XCom reads through the Astro control plane. - Fixed a bug where a task that completed within a single metrics-collection interval produced a metrics record that the control plane rejected, blocking the whole metrics batch and causing repeated
Failed to send task metricserrors. - Fixed docstring redaction for task groups: the Dag processor now redacts
doc_mdin addition totooltip, including on task groups nested more than one level deep, before Dags leave the agent. - Fixed a bug where the Dag processor could send stale parse results to the control plane after a Dag bundle version update.
Images included
See Astro Remote Execution Agent 1.8.0 images included.
Astro Remote Execution Agent and Sentinel 1.7.4
- Release date: July 23, 2026
Additional improvements
- Updated Agent Client images to include the 3.2-6 Runtime version.
- Updated bundled dependencies to address security vulnerabilities in
click.
Images included
See Astro Remote Execution Agent 1.7.4 images included.
Astro Remote Execution Agent and Sentinel 1.7.3
- Release date: July 14, 2026
Additional improvements
- Updated bundled dependencies to address security vulnerabilities in
cryptography,pyjwt,python-multipart, andstarlette.
Bug fixes
- Fixed a bug where the local HTTP proxy in the agent could stop forwarding task heartbeats when an unresponsive upstream connection held a connection-pool slot indefinitely. The proxy client now sets explicit timeouts.
Images included
See Astro Remote Execution Agent 1.7.3 images included.
Astro Remote Execution Agent and Sentinel 1.7.2
- Release date: July 1, 2026
Additional improvements
- Updated Agent Client images to include the 3.0-16 and 3.1-17 Runtime versions.
Images included
See Astro Remote Execution Agent 1.7.2 images included.
Astro Remote Execution Agent and Sentinel 1.7.1
- Release date: June 4, 2026
Additional improvements
- Added Astro Runtime 3.2-5 to the Agent Client images.
- Each agent component reports a snapshot of its resolved configuration to the control plane at startup, so you can review the effective settings and how they change over time. Secrets are redacted before the snapshot is sent. Reporting is on by default; set
ASTRO_AGENT_CLIENT_CONFIG_REPORTER_ENABLED=falseto opt out for a component. - Removed a blocking call from the worker heartbeat path, reducing task-start latency.
- The Dag processor heartbeat path now exposes Prometheus metrics, including heartbeat duration, payload size, number of Dags sent, request outcomes, and parse-cache hit rate.
- The agent now exposes a per-component health gauge on the
/metricsendpoint, so you can alert on the health of individual components instead of relying only on the Kubernetes probe. - Where Sentinel is integrated, the Sentinel dashboard now surfaces Kubernetes Pod events for an unhealthy component, so you can see why a container failed its readiness check.
Bug fixes
- Fixed a bug where triggers that read connections or variables, for example through
BaseHook.get_connection()orVariable.get(), failed withForbiddenSessionUseError. The Triggerer now proxies connection and variable access through the execution API on all supported runtimes. - Fixed Human-in-the-Loop operators on Airflow 3.1 and later, where a deferred trigger could fail authentication when multiple trigger tokens were cached, or fail to parse
datetimefields in the trigger payload. - Fixed a bug where Dag processor callbacks were dropped on Airflow versions before 3.1 because required fields were missing from the heartbeat payload. The agent now backfills these fields.
- Fixed a bug where a task’s reported maximum CPU usage could show an impossibly large value because of a spurious first sample.
- Where Sentinel is integrated, fixed a bug where a healthy backend could report a misleading message that the agent status was unavailable.
Images included
See Astro Remote Execution Agent 1.7.1 images included.
Astro Remote Execution Agent and Sentinel 1.6.2
- Release date: July 23, 2026
Additional improvements
- Updated Agent Client images to include the 3.2-6 Runtime version.
- Updated bundled dependencies to address security vulnerabilities in
click,cryptography,pyjwt, andpython-multipart.
Images included
See Astro Remote Execution Agent 1.6.2 images included.
Astro Remote Execution Agent and Sentinel 1.6.1
- Release date: June 1, 2026
Additional improvements
- JWT redaction now applies inside the isolated task subprocess, so trigger tokens and other JWTs are redacted from agent logs.
- Updated bundled dependencies to address security vulnerabilities in
cryptography,gitpython,urllib3,python-multipart, andmako.
Bug fixes
- Fixed a bug where an exception in the heartbeater’s run loop, such as a subprocess IPC timeout, could prevent the agent from sending its final terminating heartbeat, leaving the control plane unaware of the shutdown.
Images included
See Astro Remote Execution Agent 1.6.1 images included.
Astro Remote Execution Agent and Sentinel 1.6.0
- Release date: April 16, 2026
Airflow 3.2 support
Agent Client now supports Airflow 3.2 (Astro Runtime 3.2-1), including Python 3.13 and 3.14 compatibility.
Additional improvements
- OpenTelemetry trace contexts are now propagated to Agent Clients.
Bug fixes
- Fixed a
ValidationErrorwhen processing callbacks withdag_run.stateon Airflow versions before 3.0.5. - Fixed a bug where the worker heartbeater did not report that the agent was terminating during graceful shutdown, so the control plane was not informed that the agent was draining tasks.
- Fixed shutdown hangs in IPC socket communication where connected clients or pending write flushes could prevent the agent from shutting down.
Images included
See Astro Remote Execution Agent 1.6.0 images included.
Astro Remote Execution Agent and Sentinel 1.5.3
- Release date: July 23, 2026
Additional improvements
- Updated bundled dependencies to address security vulnerabilities in
click,cryptography,pyjwt, andpython-multipart.
Images included
See Astro Remote Execution Agent 1.5.3 images included.
Astro Remote Execution Agent and Sentinel 1.5.2
- Release date: June 1, 2026
Additional improvements
- JWT redaction now applies inside the isolated task subprocess, so trigger tokens and other JWTs are redacted from agent logs.
- Bumped the minimum required version of
apache-airflow-providers-gitto 0.3.1, which is needed for compatibility with Airflow 3.1.7 and later. - Updated bundled dependencies to address security vulnerabilities in
cryptography,gitpython,urllib3,python-multipart, andpyjwt.
Bug fixes
- Fixed a bug where an exception in the heartbeater’s run loop, such as a subprocess IPC timeout, could prevent the agent from sending its final terminating heartbeat, leaving the control plane unaware of the shutdown.
Images included
See Astro Remote Execution Agent 1.5.2 images included.
Astro Remote Execution Agent and Sentinel 1.5.1
- Release date: April 15, 2026
Bug fixes
- Fixed a bug where the worker heartbeater did not report that the agent was terminating during graceful shutdown, so the control plane was not informed that the agent was draining tasks.
- Fixed shutdown hangs in IPC socket communication where connected clients or pending write flushes could prevent the agent from shutting down.
Images included
See Astro Remote Execution Agent 1.5.1 images included.
Astro Remote Execution Agent and Sentinel 1.5.0
- Release date: March 24, 2026
XCom support for Triggerer
Triggers running in the Triggerer component can now read and write XCom values using the execution API. Each trigger receives a per-trigger JWT token for authenticated access, which is automatically refreshed to prevent expiration during long-running triggers.
Additional improvements
- Added
gc.freeze()to the Dag processor to reduce garbage collection overhead and improve memory performance. - Updated Agent Client images to include the 3.1-14 Runtime version.
- Unknown settings from configuration sources now produce a warning instead of causing a validation error.
- The Dag processor and the worker each send a final heartbeat before shutting down.
- HTTP(S) proxy environment variables are honored for clients that talk to the Astro API server.
- SIGTERM handling is consolidated across Agent Client components for more predictable shutdowns.
- Dag file queue handling was reimplemented, with more efficient behavior when Dag bundles refresh.
- The Triggerer uses a dedicated heartbeater that is decoupled from the Triggerer subprocess lifecycle, improving heartbeat reliability across process restarts.
- The Dag processor emits additional debug logging and applies a default timeout when sending messages to the coordinator over IPC.
relative_filelocis carried inDagFileParsingResultand preserved through the Dag processor coordinator.- Callback payloads use the
EmailRequestshape consistently with Airflow’s models. - Secrets masking uses imports that match the Airflow 3.0 package layout.
- Where Sentinel is integrated, the client supports agent ID tracking and container restart detection.
Bug fixes
- Fixed a bug where failed triggers could remain in the running set and cause repeated cancel loops.
- Fixed trigger handling when the task instance was null or missing (including skipping triggers with no task instance on Airflow 3.0 clients).
- Fixed Triggerer coordinator process termination so subprocesses shut down as intended.
- Fixed graceful shutdown behavior in edge cases.
- Fixed the log level used when a process has finished.
- Fixed email-related callback typing when values are built from API responses.
- Fixed
DagCallbackbehavior on older Airflow versions used with the agent. - Fixed a bug where
DagModel.bundle_versiondid not update for cached DAGs after bundle changes. - Fixed a compatibility issue in the Dag processor where the wrong method was called for adding new files on Airflow 3.0 and 3.1 vs 3.2.
- Fixed a bug where the Triggerer failed with a
LimitOverrunErrorwhen processing large IPC messages. - Fixed a bug where non-serializable trigger event payloads caused Triggerer heartbeat failures.
- Fixed
Statsimport compatibility across different Airflow 3 versions. - Fixed a bug where the Dag processor did not exit on fatal exceptions.
- Fixed a case where the managed Astro subprocess had already exited but the agent could linger; the agent now exits promptly and cleanly.
- Fixed uncaught errors in socket listener callbacks so a bad callback does not tear down the listener.
- Fixed client-side stripping of
triggering_user_namefrom callbacks for Airflow below 3.1.2.
Images included
See Astro Remote Execution Agent 1.5.0 images included.
Astro Remote Execution Agent and Sentinel 1.4.0
Internal-only release.
Astro Remote Execution Agent and Sentinel 1.3.12
- Release date: July 23, 2026
Additional improvements
- Updated bundled dependencies to address security vulnerabilities in
click,cryptography,pyjwt, andpython-multipart.
Images included
See Astro Remote Execution Agent 1.3.12 images included.
Astro Remote Execution Agent and Sentinel 1.3.11
- Release date: June 4, 2026
Additional improvements
- Updated bundled dependencies to address security vulnerabilities in
cryptography,gitpython,urllib3,python-multipart,mako, andpyjwt.
Images included
See Astro Remote Execution Agent 1.3.11 images included.
Astro Remote Execution Agent and Sentinel 1.3.10
- Release date: May 14, 2026
Additional improvements
- Bumped the minimum required version of
apache-airflow-providers-gitto 0.3.1, which is needed for compatibility with Airflow 3.1.7 and later.
Bug fixes
- Fixed a bug where an exception in the heartbeater run loop caused shutdown to skip the final terminating heartbeat, so the control plane wasn’t informed that the agent had stopped.
Images included
See Astro Remote Execution Agent 1.3.10 images included.
Astro Remote Execution Agent and Sentinel 1.3.9
- Release date: April 16, 2026
Bug fixes
- Fixed a bug where the worker heartbeater did not report that the agent was terminating during graceful shutdown, so the control plane was not informed that the agent was draining tasks.
- Fixed shutdown hangs in IPC socket communication where connected clients or pending write flushes could prevent the agent from shutting down.
Images included
See Astro Remote Execution Agent 1.3.9 images included.
Astro Remote Execution Agent and Sentinel 1.3.8
- Release date: March 25, 2026
Bug fixes
- Fixed a bug where the Triggerer failed with a
LimitOverrunErrorwhen processing large IPC messages.
Images included
See Astro Remote Execution Agent 1.3.8 images included.
Astro Remote Execution Agent and Sentinel 1.3.7
- Release date: March 4, 2026
Bug fixes
- Fixed a bug where the Triggerer agent did not exit when receiving a
409 Conflict from the API Server, which prevented it heartbeating successfully.
Images included
See Astro Remote Execution Agent 1.3.7 images included.
Astro Remote Execution Agent and Sentinel 1.3.6
- Release date: February 18, 2026
Improvements
- Small performance and telemetry enhancements to the remote Dag Processor agent.
Images included
See Astro Remote Execution Agent 1.3.6 images included.
Astro Remote Execution Agent and Sentinel 1.3.5
- Release date: February 13, 2026
Bug fixes
- Fixed a bug where agents shutting down didn’t always correctly notify the Astro APIs, which could result in new containers being unable to register.
- Fixed a bug where the remote Dag Processor agent wouldn’t crash after a fatal exception. (In this case crashing was expected and required to allow the agent to re-register successfully.)
Images included
See Astro Remote Execution Agent 1.3.5 images included.
Astro Remote Execution Agent and Sentinel 1.3.4
- Release date: February 5, 2026
Bug fixes
- Fixed a bug where agents don’t shutdown gracefully on SIGTERM. Worker agents now wait for running tasks to finish before shutting down or until the Pod’s termination grace period expires. This fix addresses issues with running tasks being killed when an agent is terminated.
Images included
See Astro Remote Execution Agent 1.3.4 images included.
Astro Remote Execution Agent and Sentinel 1.3.3
- Release date: January 30, 2026
Agent Client versions 1.3.2 and 1.3.3 don’t handle SIGTERM gracefully. Running tasks may fail when terminating agents on these versions. This issue is fixed in Agent Client version 1.3.4, which is included in the Astro Remote Execution Agent and Sentinel 1.3.4 release.
Bug fixes
- Fixed a bug that could prevent Dag import errors from being cleared when fixed, affecting Airflow ≥ 3.1.6.
Images included
See Astro Remote Execution Agent 1.3.3 images included.
Astro Remote Execution Agent and Sentinel 1.3.2
- Release date: January 30, 2026
Agent Client versions 1.3.2 and 1.3.3 don’t handle SIGTERM gracefully. Running tasks may fail when terminating agents on these versions. This issue is fixed in Agent Client version 1.3.4, which is included in the Astro Remote Execution Agent and Sentinel 1.3.4 release.
Proxy server support
Agent Client now supports running behind an HTTP(S) proxy server. You can configure proxy settings using the usual HTTP_PROXY/HTTPS_PROXY/NO_PROXY environment variables.
Additional improvements
- Updated Agent Client images to use the 3.1-11 Runtime version.
Bug fixes
- Fixed a bug where agents wouldn’t terminate correctly if interrupted during initialization.
Images included
See Astro Remote Execution Agent 1.3.2 images included.
Astro Remote Execution Agent and Sentinel 1.3.1
- Release date: January 28, 2026
Additional improvements
- Added support for Asset Watcher and Deadline Alert triggers in Airflow 3.1.
Bug fixes
- Fixed a bug where failed triggers weren’t correctly removed from the list of triggers running in a triggerer agent.
- Fixed a bug where the same trigger could be started multiple times in the same triggerer agent.
- Fixed a bug affecting execution of callbacks on the Dag Processor in Airflow ≥ 3.1.1.
- Fixed some nil pointer reference bugs in the Helm chart templates.
- Fixed an issue where environment variables provided in
commonEnvweren’t able to override the defaults in the Helm chart.
Images included
See Astro Remote Execution Agent 1.3.1 images included.
Astro Remote Execution Agent and Sentinel 1.3.0
- Release date: January 28, 2026
Bug fixes
- Fixed a bug where an agent could get stuck in a “cordoned” state indefinitely when temporarily partitioned from the API server. Agents in this state will now detect the situation and recover automatically.
Images included
See Astro Remote Execution Agent 1.3.0 images included.
Astro Remote Execution Agent and Sentinel 1.2.3
- Release date: January 28, 2026
Additional improvements
- Added support for Asset Watcher and Deadline Alert triggers in Airflow 3.1.
- Added support for setting default values for
imageandimagePullPolicythat apply to all Agent components in the Helm chart.
Bug fixes
- Fixed a bug where failed triggers weren’t correctly removed from the list of triggers running in a triggerer agent.
- Fixed a bug where the same trigger could be started multiple times in the same triggerer agent.
- Fixed a bug affecting execution of callbacks on the Dag Processor in Airflow ≥ 3.1.1.
- Fixed some nil pointer reference bugs in the Helm chart templates.
- Fixed an issue where environment variables provided in
commonEnvweren’t able to override the defaults in the Helm chart.
Images included
See Astro Remote Execution Agent 1.2.3 images included.
Astro Remote Execution Agent and Sentinel 1.2.2
- Release date: December 9, 2025
Additional improvements
- Moved vector logging sidecar to be part of the init container, so that it keeps running throughout the lifecycle of the Pod and doesn’t terminate before the main Agent component container.
- Added support for configuring
imagePullPolicyin the Helm chart. - Updated Agent Client images to use the 3.1-7 Runtime version.
Bug fixes
- Fixed a bug in the Helm chart that prevented Worker component resources from being created correctly when multiple workers were configured.
- Don’t specify
worker.replicaswhenworker.hpa.enabledis set to true in the Helm chart. - Fixed typo with using lowercase key
valueas part ofworker.hpa.metricsin the Helm chart. - Report both running and creating triggers in the
running_triggerspart of the triggerer response to prevent starting a trigger with a given ID if it is already running or creating.
Images included
See Astro Remote Execution Agent 1.2.2 images included.
Astro Remote Execution Agent and Sentinel 1.2.1
- Release date: November 17, 2025
Additional improvements
- Updated Agent Client images to use the 3.1-4 Runtime version.
Bug fixes
- Fixed incorrect timestamp values for Dag parsing stats in the Airflow UI.
- Fixed structlog for Agent logging when using 3.0-x Runtime versions.
Images included
See Astro Remote Execution Agent 1.2.1 images included.
Astro Remote Execution Agent and Sentinel 1.2.0
- Release date: November 10, 2025
Added Sentinel to Remote Execution Agent Helm chart
Added a new Sentinel service to Remote Execution Agent Helm chart. Sentinel helps collect monitoring datapoints such as Pod, XCom backend and secrets backend statuses and reports them back to API Server. This is an experimental feature to help with Remote Execution Agent monitoring and is turned off by default in the Agent Helm chart. See Enable Sentinel for monitoring.
Additional improvements
- Added a check in the Agent Client to avoid breaking the Remote Deployment by running into forward compatibility issues. For example, Agent Client will get back 422 HTTP response code instead of regular heartbeat response if the Airflow version of the Agent Client is higher than that of the Astro Remote Deployment.
- Added support to configure
imagePullPolicyin the Remote Agent Helm chart.
Images included
See Astro Remote Execution Agent 1.2.0 images included.
Astro Remote Execution Agent 1.1.2
- Release date: January 28, 2026
Additional improvements
- Added support for Asset Watcher and Deadline Alert triggers in Airflow 3.1.
- Moved vector logging sidecar to be part of the init container, so that it keeps running throughout the lifecycle of the Pod and doesn’t terminate before the main Agent component container.
- Added support for configuring
imagePullPolicyin the Helm chart. - Added support for setting default values for
imageandimagePullPolicythat apply to all Agent components in the Helm chart.
Bug fixes
- Fixed a bug where failed triggers weren’t correctly removed from the list of triggers running in a triggerer agent.
- Fixed a bug where the same trigger could be started multiple times in the same triggerer agent.
- Fixed a bug affecting execution of callbacks on the Dag Processor in Airflow ≥ 3.1.1.
- Fixed a bug in the Helm chart that prevented Worker component resources from being created correctly when multiple workers were configured.
- Don’t specify
worker.replicaswhenworker.hpa.enabledis set to true in the Helm chart. - Fixed typo with using lowercase key
valueas part ofworker.hpa.metricsin the Helm chart. - Fixed some nil pointer reference bugs in the Helm chart templates.
- Fixed an issue where environment variables provided in
commonEnvweren’t able to override the defaults in the Helm chart.
Images included
See Astro Remote Execution Agent 1.1.2 images included.
Astro Remote Execution Agent 1.1.1
- Release date: November 17, 2025
Additional improvements
- Updated Agent Client images to use the 3.1-4 Runtime version.
Images included
See Astro Remote Execution Agent 1.1.1 images included.
Astro Remote Execution Agent 1.1.0
- Release date: September 29, 2025
Additional improvements
- Updated Agent Client images to use the 3.1-1 Runtime version.
- Added support to directly reference the Agent token file in the Helm chart.
- Added the ability to configure a custom service account and corresponding annotation per Agent component in the Helm chart.
Remote Agent Worker Kubernetes service account change
The naming convention for the Remote Agent Worker’s Kubernetes service account has been updated. Users who have configured IRSA on AWS, Workload Identity on Azure, or GCP will need to annotate the new service account appropriately. In previous releases, the service account name for the Remote Execution Agent worker was {{ resourceNamePrefix }}-worker. The default service account name has been updated to {{ resourceNamePrefix }}-worker-{{ worker.name }}. resourceNamePrefix and worker.name are both attributes set in the values.yaml file. You can also provide a custom service account, which overrides the default service account name. The custom service account name applies to all workers.
Bug fixes
- Fixed a bug where the Dag processor process didn’t close cleanly on completion.
- Fixed a bug where the Agent process crashed in the event of heartbeat failures.
Images included
See Astro Remote Execution Agent 1.1.0 images included.
Astro Remote Execution Agent 1.0.4
- Release date: August 21, 2025
Additional improvements
- Updated Agent Client images to use the 3.0-8 Runtime version.
Bug fixes
- Fixed live task logs for Hosted Astro executor Deployments.
Images included
See Astro Remote Execution Agent 1.0.4 images included.
Astro Remote Execution Agent 1.0.3
- Release date: July 15, 2025
Prevent airflow_local_settings.py Execution in Agent Processes
The Remote Execution Agent process no longer imports airflow_local_settings.py. This prevents errors from user-defined settings that rely on dependencies not available in the Remote Execution Agent’s isolated environment.
Images included
See Astro Remote Execution Agent 1.0.3 images included.
Astro Remote Execution Agent 1.0.2
- Release date: July 3, 2025
Support for Custom Service Accounts and Annotations
The Remote Execution Agent Helm chart now supports setting custom service account names and annotations for the Worker, Triggerer, and Dag processor components. This allows you to:
- Bring your own service accounts (BYO-SA) and disable the Helm-managed service account creation
- Add annotations, such as for AWS IRSA
This update supports restricted or self-managed environments where service accounts and roles are centrally controlled.
Bug fixes
- Changed working directory for Remote Execution Agent images to
/usr/local/airflowThe workdir for Remote Execution Agent images has moved from/opt/astroto/usr/local/airflowto align with Runtime images. If you have added a manualWORKDIR /usr/local/airflowdirective in your image builds you can now remove this if building from the 1.0.2 base images.
Breaking Change
If you reference /opt/astro in your Dockerfile for a Remote Execution mode Deployment, you must update those references to /usr/local/airflow.
Images included
See Astro Remote Execution Agent 1.0.2 images included.
Due to a known backwards compatibility issue in Airflow, use 3.0-1 images for Remote Deployments on Runtime 3.0-1, 3.0-2 images for Runtime 3.0-2, and 3.0-4 images for Runtime 3.0-3 and 3.0-4
Astro Remote Execution Agent 1.0.1
- Release date: June 2, 2025
Bug fixes
- Fixed a bug where the proxy rejected HEAD requests to the XCom API with a
405 Method Not Allowed. It now correctly supports HEAD requests.
Images included
See Astro Remote Execution Agent 1.0.1 images included.
Use 3.0-1 Agent images for Remote Deployments using the Astro Runtime/Orchestration Plane 3.0-1 due to an OSS Airflow Bug. You can use 3.0-2 Remote Agent images for any Astro Runtime ≥ 3.0-2.
See Upgrade considerations for more information about the Remote Execution Agent and Astro Runtime version considerations.
Astro Remote Execution Agent 1.0.0
- Release date: April 22, 2025
Introducing the Remote Execution Agent
With the release of Airflow 3.0, Astro now supports Remote Execution of Dags with the Astro Remote Execution Agent. The Remote Execution Agent allows you to keep your sensitive data and execute your Dags in your own environment, while still leveraging Astro features like day zero Airflow Runtime support, observability, and user management. The Astro Remote Execution Agent manages running the Workers, Triggerer, and Dag processors in your environment, while the Airflow Metadata Database, Scheduler, Web/API Server, and Remote Execution API remain in the Astro Orchestration plane.
See Remote Execution Agents for installation, configuration, and advanced options.
Images included
See Astro Remote Execution Agent 1.0.0 images included.
Due to a known backwards compatibility issue in Airflow, use 3.0-1 images for Remote Deployments on Runtime 3.0-1, 3.0-2 images for Runtime 3.0-2, and 3.0-4 images for Runtime 3.0-3 and 3.0-4