Skip to main content

CLI tool to run shell commands on ec2 instances.

Project description

Supported cloud platforms


  • [x] AWS EC2


  • [ ] Openstack via ec2 API endpoint



  • [x] Multiple remote users (if can’t authenticate - will try next username)
  • [x] Filter by tags
  • [x] Parallel execution


  • [ ] Profiles (group settings and filters in named profile, and specify profile on run)
  • [ ] Filter by launch date (launched-before and launched-after )
  • [ ] Filter by keypair
  • [ ] –dry-run flag


Install the latest stable version:

pip install


Get help: --help run --help run-one --help

Create settings file:

cat >><<-EOF
remote_user = ubuntu,centos,root
private_key = /home/ubuntu/.ssh/ec2.pem
aws_access_key_id = access-key
aws_secret_access_key = secret-access-key
aws_region = eu-west-1

Filter by tag ‘owner=automation’ and run command on resulted instances: run -f owner=automation 'df -h'

Run script: run -f owner=automation<<-EOF
echo hello
uname -a

Run any script or binary (assuming it’s compatible with target hosts): run -f owner=automation < run -f owner=automation < /usr/local/bin/weather

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Files for, version 0.1
Filename, size File type Python version Upload date Hashes
Filename, size (6.1 kB) File type Wheel Python version 2.7 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page