Skip to main content

Executing commands using SSH concurrently on multiple hosts

Project description



Executing commands with ssh concurrently on multiple hosts using asyncio


pip install concurrent-ssh
# Or from the latest GitHub version
pip install git+


Note: ensure that ssh is in your PATH environment variables.


Use -H or --hosts to specify the hosts to run the commands on:

cssh -H <host1> <host2> .... <host_n> -- <command>
# pass extra ssh options
cssh -o="-q -4" -H <host1> <host2> .... <host_n> -- <command>
# read hosts from file
cssh -f hosts.txt -- <command>

Note that -- is necessary to separate the options and the command. For -o/--options to work correctly, use = to prevent it from being parsed as another option.

The standard input (stdin) of the cssh process is piped to the stdin of every spawned processes.

cssh can handle signals as follows:

  • Upon receiving one SIGINT (including keyboard interrupt) or SIGTERM, cssh will send SIGTERM to all spawned processes.
  • Upon receiving more than one of them, cssh will instead send SIGKILL to kill all spawned processes.


It can also be used as a library:

import asyncio
from cssh.executor import SshExecutor

async def main():
  hosts = ["host1", "host2"]
  executor = SshExecutor(hosts)
  # running concurrently
  await"some_command --test")

  # access stdout for all hosts (or stderr)
  async for host, out in executor.stdout:
    print(f"{host}: {out}")

  # wait until all finished
  ret_codes = await executor.wait()

See more usage in cssh/


To set up the development environment, first clone this repo.

Then it's recommended to usevenv:

# suppose PWD is the root dir of the repo
python -m venv venv
# activate the environment``
source venv/bin/activate
pip install -r requirements.txt

To deactivate, run deactivate.


This project is licensed under AGPL-3.0. Copyright notice:

Copyright (C) 2023 DCsunset

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published
by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <>.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

concurrent-ssh-0.3.1.tar.gz (17.0 kB view hashes)

Uploaded Source

Built Distribution

concurrent_ssh-0.3.1-py3-none-any.whl (19.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page