Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

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

Release history Release notifications

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

Supported by

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