dvc-ssh

library4.3.0pypypi✓ verified 88d ago

SSH plugin for DVC (Data Version Control) that enables remote storage on SSH servers. Current version 4.2.2, requires Python >=3.9. Active development with regular releases.

data devops

pip install dvc-ssh

github ↗package ↗docs ↗

INSTALL

IMPORT

SIG · DVC-SSH

dvc-ssh

datapythonv4.3.0

Install

19.6s avg

Import

—

Disk

168MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.3.0 · 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.910 runs

installs and imports cleanly · install 0.0s · import 0.000s · 158.3MB

glibc

py 3.10–3.910 runs

installs and imports cleanly · install 19.6s · import 0.000s · 163MB

168MB installed

● package 168MB

Code

Verified usage

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

SSHFileSystem

✓ from dvc_ssh import SSHFileSystem

✗ from dvc import DVC

Initialize DVC repo with SSH remote. Run inside a git repository.

import os from dvc import DVC from dvc.repo import Repo # Initialize DVC repository (in existing git repo) repo = Repo.init() # Add remote SSH storage ssh_url = f"ssh://{os.environ.get('SSH_USER', 'user')}@{os.environ.get('SSH_HOST', 'example.com')}:{os.environ.get('SSH_PORT', '22')}{os.environ.get('SSH_PATH', '/path/to/storage')}" repo.add_remote(name='myremote', url=ssh_url, default=False) # Print configured remotes print(repo.config['remote'])

Debug

Known issues

breakingVersion 4.0.0 replaced dvc_objects.callbacks with fsspec.callbacks. Custom callback implementations must be updated.

fix

Replace any imports from dvc_objects.callbacks with from fsspec.callbacks and update callback usage accordingly.

affects: >=4.0.0

deprecatedVersion 3.0.0 drops support for DVC 2.x. Ensure DVC version is >=3.0.0.

fix

Upgrade DVC to version 3.x or later.

affects: >=3.0.0

gotchaSSH configuration (host key verification, auth methods) is handled by asyncssh. Default behavior may prompt for passwords interactively.

fix

Set up passwordless SSH keys or configure asyncssh options via dvc config or environment variables.

affects: all

gotchaFile transfer uses atomic write by default since v4.2.2, which may fail on some filesystems with limited permissions.

fix

If atomic writes cause issues, you can set DVC_NO_ATOMIC_WRITE=1 environment variable or adjust remote permissions.

affects: >=4.2.2

Upgrade

Version history

4.3.0latest on PyPI · released May 22, 2026

Audit

Dependencies

dvcrequiredCore DVC functionality required

asyncsshrequiredSSH connection handling (>=2.19.0)

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/iterative/dvc-ssh ↗

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

docshttps://dvc.org/doc ↗