Skip to main content

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


# ec2-ssh

% ec2-ssh nginx2
# equivalent to
# ssh

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

# Specifying the user with an environment variable
% EC2_SSH_USER=deploy ec2-ssh nginx2

# 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.9.0 (2017-09-08)

  • Both ec2-host and ec2-ssh now only show/use instances in the running state.

  • Use the Public IP for an instance if EC2 no Public DNS for a public instance. It turns out EC2 may not return the Public DNS even when a Public IP is assigned.

1.8.0 (2017-07-19)

  • Use private IP addresses for instances that don’t have public ones. Such instances are not guaranteed to be accessible from the current host, depending on networking setup, but it’s better the tool let’s you try it.

1.7.0 (2017-04-23)

  • Rewrite to use’s entry_points feature, rather than scripts. This makes everything importable from the ec2_ssh module and makes ec2-ssh faster as calling the ec2-host behaviour no longer requires subprocess.

1.6.0 (2017-04-13)

  • ec2-ssh supports specifying the username with the -u/--user flag or the EC2_SSH_USER environment variable.

1.5.3 (2017-03-23)

  • Acquired the PyPI name ec2-ssh, moved fork back there from ec2-ssh-yplan.

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

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

ec2-ssh-1.9.0.tar.gz (5.4 kB view hashes)

Uploaded Source

Built Distribution

ec2_ssh-1.9.0-py2.py3-none-any.whl (6.8 kB view hashes)

Uploaded Python 2 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