Skip to main content

SSH into your EC2 instances based on their configurations.

Project description


Another SSH utility for AWS


$ pip install awsh

If you never configured awscli before.

$ aws configure

Alternatively it can be downloaded on pypi.


  • Python 2 or 3

What does it do?

It gives you a list of hosts you have access to and preconfigure ssh with the proper key and user (assuming they have not been overridden by a configuration management tool). You can filter by instance name and if it matches only one instance it will log to it.

Use Cases

  • You are running Elasticbeanstalk, EMR or something that creates it’s own instance automatically.

  • You are using different key-set for different instances and you can’t remember which one does what.

  • Instances are coming and going and you lost track of what is available.


awsh -h
usage: awsh [-h] [--users USERS [USERS ...]] [--region REGION] [-i KEY_PATH]
            [-c COMMAND] [--keys KEYS] [--timeout TIMEOUT] [--version]

SSH into AWS instances. the default Assumes that everything runs on Ubuntu and
or Amazon's AMIs. ex: "awsh --users user1 user2 --region us-west-2 --keys
'~/.keys' instance-name". Note that "awsh --users user1 user2 instance-name"
will not be parsed properly due to the nature of nargs. In that case you may
want to do: "awsh instance-name --users user1 user2".

positional arguments:
  filter                Optional name filter. If only one instance is found,
                        it will connect to it directly.

optional arguments:
  -h, --help            show this help message and exit
  --users USERS [USERS ...]
                        Specify the users to try.
  --region REGION       Specify the aws region.
  -i KEY_PATH           Specific key path, overrides, --keys
  -c COMMAND            Translates to ssh -C
  --keys KEYS           Directory of the private keys.
  --timeout TIMEOUT     SSH connection timeout.
  --version             Returns awsh's version.

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

awsh-1.0.10.tar.gz (4.2 kB view hashes)

Uploaded source

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