Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

SSH into EC2 instances via tag name

Project Description

A pair of command line utilities for finding and SSH-ing into your Amazon EC2 instances by tag (such as ‘Name’).

Forked from Instagram original code by YPlan.


From pip:

pip install ec2-ssh-yplan


# ec2-ssh

% ec2-ssh nginx2
# equivalent to
# ssh

% ec2-ssh root@appserver
% ec2-ssh deploy@nginx2 sudo restart nginx

# ec2-host

# w/o arg: prints all active instances
% ec2-host

# w/ arg
% ec2-host backend

# w/ tag arg too
% ec2-host -t environment production



  • Next version release notes here

1.5.2 (2016-08-17)

  • Fix Python 3 bug with subprocess output type

1.5.1 (2016-01-21)

  • Pip failed to receive wheel in version 1.5.0, re-uploading

1.5.0 (2016-01-21)

  • Now using boto3

1.4.0 (2016-01-07)

  • ec2-ssh rewritten in Python. As part of this, the automatic ‘pretty prompt’ has been removed.

1.3.0 (2016-01-06)

  • Forked by YPlan
  • Output from ec2-host is now in random order, allowing ec2-ssh to spread logins between similar instances
  • Python 3 compatibility

1.2.1 (2011-11-27)

  • Fix issue when ec2-host finds one offline instance with same name as an online instance

1.2 (2011-11-27)

  • Merged pull requests to add region and tag support

1.1.1 (2011-11-17)

  • Add line echoing host before establishing SSH connection

1.1 (2011-11-15)

  • override prompt (PS1) to show tag name

1.0 (2011-09-05)

  • initial release

Release History

History Node


This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(6.0 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Aug 17, 2016
(4.6 kB) Copy SHA256 Hash SHA256
Source None Aug 17, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers