Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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

Release History

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
(7.2 kB) Copy SHA256 Hash SHA256
Wheel 3.4 Aug 7, 2015
(6.6 kB) Copy SHA256 Hash SHA256
Source None Aug 7, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers