Skip to main content

Query for Amazon EC2 instances on the command-line.

Project description

Quickly query for EC2 instances on the command-line.

Status: in-development


Collar makes it easier for you to access on-demand servers that you’ve spun up on Amazon EC2. It’s a command-line tool for querying and logging into these servers, a tool which lets you filter using immutable instance parameters (e.g. size, security group) as well as mutable tags.


Requires Python 3.x and pip. Then install with:

pip install collar


You’ll need to provide access to your Amazon account by creating a ~/.botorc file. See Configuring Boto Credentials.

Examples of use

Listing instances

# list all instances by id
collar list

# TODO: list all instance by public domain
collar list --public

# TODO: list all instances by private domain
collar list --private

# list only instances with tag Role:worker
collar list Role:worker

# constrain with many tags at once
collar list Role:worker Customer:blubbersoft

Describing instances

# describe all instances
collar describe

# describe a named instance
collar describe Name:projet-alpha

# describe a general query
collar describe Role:worker Customer:blubbersoft


BSD licenced.


0.1.0 (2015-08-06)

  • First release on PyPI
  • Querying for ids
  • Filtering using tags and other instance characteristics
  • Providing public and private domain names

Project details

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
collar-0.1.1-py3-none-any.whl (7.2 kB) Copy SHA256 hash SHA256 Wheel 3.4
collar-0.1.1.tar.gz (6.6 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page