dagster-ssh

library0.29.10pypypi✓ verified 85d ago

Provides SSH/SFTP resource and I/O manager for Dagster pipelines. Current version: 0.29.3. Release cadence matches Dagster core releases (approximately monthly).

workflow data devops

pip install dagster-ssh

github ↗package ↗

INSTALL

IMPORT

SIG · DAGSTER-SSH

dagster-ssh

workflowpythonv0.29.10

Install

14.1s avg

Import

2924ms

Disk

158MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.29.10 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 3.048s · 155.4MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 14.1s · import 2.800s · 150MB

158MB installed

● package 158MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

SSHResource

✓ from dagster_ssh import SSHResource

✗ from dagster_ssh.resources import SSHResource

SSHResource was moved to top-level import in 0.15.0; the old path may still work but is deprecated.

SSHIOManager

✓ from dagster_ssh import SSHIOManager

✗ from dagster_ssh.io_manager import SSHIOManager

SSHIOManager is directly exposed from dagster_ssh since 0.16.0.

Configure an SSH resource with environment variables for credentials.

from dagster_ssh import SSHResource ssh_resource = SSHResource( remote_host=os.environ.get('SSH_HOST', ''), remote_port=22, username=os.environ.get('SSH_USERNAME', ''), password=os.environ.get('SSH_PASSWORD', ''), key_file=os.environ.get('SSH_KEY_FILE', None), ) print('SSH resource configured successfully.')

Debug

Known issues

breakingIn version 0.15.0, the SSH resource import path changed from `dagster_ssh.resources.SSHResource` to `dagster_ssh.SSHResource`. Old imports will break. Update your imports accordingly.

fix

Change `from dagster_ssh.resources import SSHResource` to `from dagster_ssh import SSHResource`.

affects: >=0.15.0

deprecatedThe `key_file` parameter in SSHResource is deprecated in favor of `key_data` for inline key content. As of 0.22.0, passing a file path may continue to work but raises a deprecation warning.

fix

Instead of `key_file='/path/to/key'`, use `key_data=open('/path/to/key').read()`.

affects: >=0.22.0

gotchaWhen using SSHIOManager, ensure the SSH host is reachable and credentials are correct before materializing assets. The IO manager does not validate connectivity at configuration time, only during runtime.

fix

Add a resource initialization check in your job or sensor to catch misconfigurations early.

affects: all

gotchaSSHResource does not automatically close connections when used as a context manager. Always wrap usage in a `with ssh_resource.get_connection():` block to avoid resource leaks.

fix

Use `with ssh_resource.get_connection() as conn:` to ensure connections are properly closed.

affects: all

Errors

Common errors & fixes

ImportError: cannot import name 'SSHResource' from 'dagster_ssh'

The old import path `from dagster_ssh.resources import SSHResource` no longer works in dagster-ssh >=0.15.0.

fix

Use `from dagster_ssh import SSHResource` instead.

ModuleNotFoundError: No module named 'paramiko'

The `paramiko` library is a required dependency that is not automatically installed with dagster-core, but it is bundled with dagster-ssh. If using a minimal installation, you may be missing it.

fix

Install dagster-ssh with `pip install dagster-ssh` (includes paramiko).

paramiko.ssh_exception.AuthenticationException: Authentication failed.

SSHResource configured with incorrect credentials or key file path.

fix

Verify SSH credentials in environment variables or key_data contents. For key-based auth, ensure `key_data` (or `key_file`) corresponds to a valid private key. Try connecting manually via `ssh` command.

Upgrade

Version history

0.29.10latest on PyPI · released Jun 18, 2026

Audit

Dependencies

dagsterrequiredCore dependency for Dagster integrations

paramikorequiredSSH protocol implementation

Agent activity

24 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/dagster-io/dagster ↗

packagehttps://pypi.org/project/dagster-ssh/ ↗