jumpssh

What it is and what it does

JumpSSH is a Python library that simplifies running commands and transferring files on remote servers when direct SSH access is not available. It wraps paramiko to handle multi-hop SSH connections through one or more gateway servers, eliminating the need to upload scripts or manually configure SSH tunnels for each bastion host. A single SSH session can execute multiple commands in parallel and retrieve individual results, and the library supports both password and key-based authentication.

The package provides a high-level API for common tasks: executing remote commands and capturing output or exit codes, checking file existence, uploading and downloading files, and making HTTP requests to services accessible only through the gateway. It is designed for developers who need programmatic SSH access without the complexity of low-level paramiko calls or the configuration overhead of Ansible.

Use it for:

• Execute maintenance commands on servers behind a corporate firewall or bastion host without manual SSH tunneling.
• Automate file deployment and log collection across multiple servers reached through a single gateway.
• Query REST APIs running on internal-only hosts by routing requests through an SSH gateway.
• Check package installation status or system state on remote hosts in a multi-hop network topology.
• Build deployment scripts that work with jump servers without modifying local SSH configuration.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

JumpSSH runs commands on remote servers through SSH gateways, supporting multi-hop connections and file operations without uploading scripts to remote hosts.

Yes, if you need multi-hop SSH automation and can tolerate dormant maintenance. The library is stable, has no known vulnerabilities, low install friction, and a permissive license. However, verify that it works with your target Python version and that paramiko updates are sufficient for your security requirements, given that jumpssh itself has not been updated since 2020.

Install

jumpssh on PyPI

pip install jumpssh

uv add jumpssh

poetry add jumpssh

Installing jumpssh

Before you install

Low install friction with a single dependency on paramiko. Maintenance is dormant—last release was 2020-11-06 and no commits since 2024-12-01—but the codebase is stable and archived status is false, suggesting it is maintained in a minimal capacity.

License in practice

MIT license is permissive and imposes no restrictions on use, modification, or redistribution in proprietary or commercial projects.

Quickstart

pip install jumpssh

from jumpssh import SSHSession

gateway = SSHSession('gateway.example.com', 'user', password='pass').open()
remote = gateway.get_remote_session('remote.example.com', password='pass2')
print(remote.get_cmd_output('ls -la'))

Verify before relying

• Whether the package works reliably with modern Python versions beyond 3.9 given the dormant maintenance status.
• Whether paramiko's security updates are automatically inherited or if jumpssh requires explicit updates to stay current.

Package facts

Evidence: jumpssh-1.6.5-py3-none-any.whl

Tags

More Software Development packages