---
id: jumpssh
version: "1.6.5"
license: MIT license
license_treatment: permissive
maintenance: dormant
---

# jumpssh — Python library for remote ssh calls through a gateway.

License: permissive · Maintenance: dormant · Downloads: 104.2K/mo

## 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 above — 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

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

- License: MIT license (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 104.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ssh gateway bastion host, remote command execution through jump server, multi-hop ssh connections, paramiko wrapper ssh automation, ssh tunneling python library, bastion host ssh client, remote file transfer ssh gateway, ssh-automation, bastion-gateway, remote-execution

[View on SkillFed](https://skillfed.io/packages/jumpssh) · [View on PyPI](https://pypi.org/project/jumpssh/)