Airflow Summit 2025 is coming October 07-09. Register now to secure your spot!

apache-airflow-providers-ssh

Changelog

4.1.4

Release Date: 2025-09-22

Misc

  • Switch all airflow logging to structlog (#52651)

4.1.3

Release Date: 2025-08-11

Misc

  • Limit paramiko to '< 4.0.0' till we remove DSS support (#54078)

4.1.2

Release Date: 2025-08-02

Misc

  • Add Python 3.13 support for Airflow. (#46891)

  • Remove type ignore across codebase after mypy upgrade (#53243)

  • Cleanup type ignores in ssh provider where possible (#53257)

  • Remove upper-binding for "python-requires" (#52980)

  • Temporarily switch to use >=,< pattern instead of '~=' (#52967)

  • Move all BaseHook usages in providers to version_compat in ssh (#52780)

4.1.1

Release Date: 2025-07-06

Misc

  • Move 'BaseHook' implementation to task SDK (#51873)

  • Provider Migration: Replace 'BaseOperator' to Task SDK for 'ssh' (#52558)

  • Drop support for Python 3.9 (#52072)

4.1.0

Release Date: 2025-05-18

Note

This release of provider is only available for Airflow 2.10+ as explained in the Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.

Misc

  • Bump min Airflow version in providers to 2.10 (#49843)

4.0.1

Release Date: 2025-03-13

Bug Fixes

  • Make command for replacing newlines with literals '\n' in 'SSHOperator'connection MacOs/Linux compatible (#47491)

Misc

  • Upgrade flit to 3.11.0 (#46938)

4.0.0

Release Date: 2024-12-26

Note

This release of provider is only available for Airflow 2.9+ as explained in the Apache Airflow providers support policy.

Breaking changes

Warning

All deprecated classes, parameters and features have been removed from the SSH provider package. The following breaking changes were introduced:

  • Hooks

    • Remove attribute timeout from airflow.providers.ssh.hooks.ssh.SSHHook. Use parameter conn_timeout instead.

    • The context manager of SSHHook is deprecated. Please use get_conn() as a context manager instead.

    • SSHHook.create_tunnel() is deprecated, Please use get_tunnel() instead. But please note that the order of the parameters have changed.

  • operators

    • The deprecated get_hook() method is removed in airflow.providers.ssh.operators.ssh.SSHOperator. Please use hook attribute instead.

    • Deprecated exec_ssh_client_command() method on SSHOperator is removed, call ssh_hook.exec_ssh_client_command() instead

  • Remove Provider Deprecations in SSH (#44544)

Features

  • Add host_proxy_cmd parameter to SSHHook and SFTPHook (#44565)

Misc

  • Bump minimum Airflow version in providers to Airflow 2.9.0 (#44956)

  • Remove XCom pickling (#43905)

3.14.0

Release Date: 2024-10-31

Features

  • SSHHook expose auth_timeout parameter (#43048)

3.13.1

Release Date: 2024-08-28

Bug Fixes

  • SSHHook: check if existing connection is still alive (#41061)

3.13.0

Release Date: 2024-08-22

Note

This release of provider is only available for Airflow 2.8+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.8.0 (#41396)

3.12.0

Release Date: 2024-08-06

Features

  • Add on kill to ssh (#40377)

3.11.2

Release Date: 2024-06-27

Misc

  • implement per-provider tests with lowest-direct dependency resolution (#39946)

3.11.1

Release Date: 2024-05-30

Misc

  • Faster 'airflow_version' imports (#39552)

  • Simplify 'airflow_version' imports (#39497)

3.11.0

Release Date: 2024-05-06

Note

This release of provider is only available for Airflow 2.7+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.7.0 (#39240)

3.10.1

Release Date: 2024-02-15

Misc

  • feat: Switch all class, functions, methods deprecations to decorators (#36876)

3.10.0

Release Date: 2023-12-27

Features

  • Add skip_on_exit_code to SSHOperator (#36303)

Bug Fixes

  • Allow SSHOperator.skip_on_exit_code to be zero (#36358)

  • Follow BaseHook connection fields method signature in child classes (#36086)

Misc

  • Review and mark found potential SSH security issues by bandit (#36162)

3.9.0

Release Date: 2023-12-12

Note

This release of provider is only available for Airflow 2.6+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers to Airflow 2.6.0 (#36017)

3.8.1

Release Date: 2023-10-31

Misc

  • Consolidate stacklevel in ssh operator warning (#35151)

3.8.0

Release Date: 2023-10-17

Note

This release of provider is only available for Airflow 2.5+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump min airflow version of providers (#34728)

  • add warn stacklevel=2 to ssh hook (#34527)

3.7.3

Release Date: 2023-09-12

Misc

  • Use literal dict instead of calling dict() in providers (#33761)

  • E731: replace lambda by a def method in Airflow providers (#33757)

3.7.2

Release Date: 2023-08-29

Misc

  • Use str.splitlines() to split lines in providers (#33593)

  • Simplify conditions on len() in other providers (#33569)

3.7.1

Release Date: 2023-06-23

Note

This release dropped support for Python 3.7

Misc

  • Remove Python 3.7 support (#30963)

3.7.0

Release Date: 2023-05-22

Note

This release of provider is only available for Airflow 2.4+ as explained in the Apache Airflow providers support policy.

Misc

  • Bump minimum Airflow version in providers (#30917)

3.6.0

Release Date: 2023-04-06

Features

  • SSHOperator - Restore ability to override SSHHook cmd_timeout (#30190)

3.5.0

Release Date: 2023-03-06

Features

  • SSH Provider: Add cmd_timeout to ssh connection extra (#29347)

3.4.0

Release Date: 2023-01-05

Features

  • Add .bash and other extensions to SSHOperator template_ext (#28617)

  • Add test_connection method for SSHHook (#28184)

  • SSH task exit code added to XCOM as 'ssh_exit' key (#27370)

Misc

  • Remove outdated compat imports/code from providers (#28507)

  • [misc] Get rid of 'pass' statement in conditions (#27775)

3.3.0

Release Date: 2022-11-18

Note

This release of provider is only available for Airflow 2.3+ as explained in the Apache Airflow providers support policy.

Misc

  • Move min airflow version to 2.3.0 for all providers (#27196)

Features

  • Added docs regarding templated field (#27301)

  • Added environment to templated SSHOperator fields (#26824)

  • Apply log formatter on every output line in SSHOperator (#27442)

Bug Fixes

  • A few docs fixups (#26788)

  • SSHOperator ignores cmd_timeout (#27182) (#27184)

3.2.0

Release Date: 2022-10-01

Features

  • feat: load host keys to save new host key (#25979)

3.1.0

Release Date: 2022-07-16

Features

  • Less verbose logging in ssh operator (#24915)

  • Convert sftp hook to use paramiko instead of pysftp (#24512)

Bug Fixes

  • Update providers to use functools compat for ''cached_property'' (#24582)

3.0.0

Release Date: 2022-06-13

Breaking changes

Note

This release of provider is only available for Airflow 2.2+ as explained in the Apache Airflow providers support policy.

Features

  • Add disabled_algorithms as an extra parameter for SSH connections (#24090)

Bug Fixes

  • fixing SSHHook bug when using allow_host_key_change param (#24116)

2.4.4

Release Date: 2022-05-16

Bug Fixes

  • Add exception to catch single line private keys (#23043)

2.4.3

Release Date: 2022-03-26

Bug Fixes

  • Fix mistakenly added install_requires for all providers (#22382)

2.4.2

Release Date: 2022-03-19

Misc

  • Add Trove classifiers in PyPI (Framework :: Apache Airflow :: Provider)

2.4.1

Release Date: 2022-03-10

Misc

  • Support for Python 3.10

2.4.0

Release Date: 2022-02-13

Features

  • Add a retry with wait interval for SSH operator (#14489)

  • Add banner_timeout feature to SSH Hook/Operator (#21262)

  • Add a retry with wait interval for SSH operator #14489 (#19981)

  • Delay the creation of ssh proxy until get_conn() (#20474) (#20474)

2.3.0

Release Date: 2021-11-04

Features

  • Refactor SSHOperator so a subclass can run many commands (#10874) (#17378)

  • update minimum version of sshtunnel to 0.3.2 (#18684)

  • Correctly handle get_pty attribute if command passed as XComArg or template (#19323)

2.2.0

Release Date: 2021-10-05

Features

  • [Airflow 16364] Add conn_timeout and cmd_timeout params to SSHOperator; add conn_timeout param to SSHHook (#17236)

2.1.1

Release Date: 2021-09-03

Misc

  • Optimise connection importing for Airflow 2.2.0

2.1.0

Release Date: 2021-08-02

Features

  • Add support for non-RSA type key for SFTP hook (#16314)

Bug Fixes

  • SSHHook: Using correct hostname for host_key when using non-default ssh port (#15964)

  • Correctly load openssh-gerenated private keys in SSHHook (#16756)

2.0.0

Release Date: 2021-06-23

Breaking changes

  • Auto-apply apply_default decorator (#15667)

Warning

Due to apply_default decorator removal, this version of the provider requires Airflow 2.1.0+. If your Airflow version is < 2.1.0, and you want to install this provider version, first upgrade Airflow to at least version 2.1.0. Otherwise your Airflow package version will be upgraded automatically and you will have to manually run airflow upgrade db to complete the migration.

Bug Fixes

  • Display explicit error in case UID has no actual username (#15212)

1.3.0

Release Date: 2021-04-13

Features

  • A bunch of template_fields_renderers additions (#15130)

1.2.0

Release Date: 2021-03-07

Features

  • Added support for DSS, ECDSA, and Ed25519 private keys in SSHHook (#12467)

1.1.0

Release Date: 2021-02-08

Updated documentation and readme files.

Features

  • [AIRFLOW-7044] Host key can be specified via SSH connection extras. (#12944)

1.0.0

Release Date: 2020-12-14

Initial version of the provider.

Was this entry helpful?