skip to navigation
skip to content

collar 0.1.1

Query for Amazon EC2 instances on the command-line.

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
File Type Py Version Uploaded on Size
collar-0.1.1-py3-none-any.whl (md5, pgp) Python Wheel 3.4 2015-08-07 7KB
collar-0.1.1.tar.gz (md5, pgp) Source 2015-08-07 6KB