Skip to content
A tool for creating EBS AMIs. This tool currently works for CentOS/RedHat Linux images and is intended to run on an EC2 instance.
Python Makefile
Branch: master
Clone or download
bmoyles and asher - add support for recursive unmount (#270)
- the volume plugin now simply handles attaching/detaching. mounting and unmounting root happens as a part of chroot setup/teardown
- if something goes wrong while setting up the chroot, try to unmount to avoid leaking volumes
- in the busy_mount wrapper around lsof, filter output for the case when it is a bind mount that is busy and processes outside the chroot may have open handles
Latest commit 822d167 Nov 21, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.


aminator - Easily create application-specific custom AMIs

Aminator creates a custom AMI from just:

  • A base ami ID
  • A link to a deb or rpm package that installs your application.

This is useful for many AWS workflows, particularly ones that take advantage of auto-scaling groups.


  • Python 2.7 (Python 3.x support not yet available)
  • Linux or UNIX cloud instance (EC2 currently supported)


Clone this repository and run:

# python install


# pip install git+


usage: aminate [-h] [-e ENVIRONMENT] [--version] [--debug] [-n NAME]
               [-s SUFFIX] [-c CREATOR] (-b BASE_AMI_NAME | -B BASE_AMI_ID)
               [--ec2-region REGION] [--boto-secure] [--boto-debug]

positional arguments:
  package               package to aminate. A string resolvable by the native
                        package manager or a file system path or http url to
                        the package file.

optional arguments:
  -h, --help            show this help message and exit
                        The environment configuration for amination
  --version             show program's version number and exit
  --debug               Verbose debugging output

AMI Tagging and Naming:
  Tagging and naming options for the resultant AMI

  -n NAME, --name NAME  name of resultant AMI (default package_name-version-
  -s SUFFIX, --suffix SUFFIX
                        suffix of ami name, (default yyyymmddHHMM)
  -c CREATOR, --creator CREATOR
                        The user who is aminating. The resultant AMI will
                        receive a creator tag w/ this user

Base AMI:
  EITHER AMI id OR name, not both!

  -b BASE_AMI_NAME, --base-ami-name BASE_AMI_NAME
                        The name of the base AMI used in provisioning
  -B BASE_AMI_ID, --base-ami-id BASE_AMI_ID
                        The id of the base AMI used in provisioning

EC2 Options:
  EC2 Connection Information

  --ec2-region REGION   EC2 region (default: us-east-1)
  --boto-secure         Connect via https
  --boto-debug          Boto debug output


The rough amination workflow:

  1. Create a volume from the snapshot of the base AMI
  2. Attach and mount the volume
  3. Chroot into mounted volume
  4. Provision application onto mounted volume using rpm or deb package
  5. Unmount the volume and create a snapshot
  6. Register the snapshot as an AMI



See the aminator wiki for documentation


Copyright 2013 Netflix, Inc.

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

You can’t perform that action at this time.