<!--[metadata]>
+++
title = "Amazon Web Services"
description = "Amazon Web Services driver for machine"
keywords = ["machine, Amazon Web Services, driver"]
[menu.main]
parent="smn_machine_drivers"
+++
<![end-metadata]-->

# Amazon Web Services
Create machines on [Amazon Web Services](http://aws.amazon.com). You will need
an Access Key ID, Secret Access Key and a VPC ID. To find the VPC ID, login to
the AWS console and go to Services -> VPC -> Your VPCs. Select the one where you
would like to launch the instance.

Options:

 - `--amazonec2-access-key`: **required** Your access key id for the Amazon Web Services API.
 - `--amazonec2-secret-key`: **required** Your secret access key for the Amazon Web Services API.
 - `--amazonec2-session-token`: Your session token for the Amazon Web Services API.
 - `--amazonec2-ami`: The AMI ID of the instance to use.
 - `--amazonec2-region`: The region to use when launching the instance.
 - `--amazonec2-vpc-id`: **required** Your VPC ID to launch the instance in.
 - `--amazonec2-zone`: The AWS zone to launch the instance in (i.e. one of a,b,c,d,e).
 - `--amazonec2-subnet-id`: AWS VPC subnet id.
 - `--amazonec2-security-group`: AWS VPC security group name.
 - `--amazonec2-instance-type`: The instance type to run.
 - `--amazonec2-root-size`: The root disk size of the instance (in GB).
 - `--amazonec2-iam-instance-profile`: The AWS IAM role name to be used as the instance profile.
 - `--amazonec2-ssh-user`: SSH Login user name.
 - `--amazonec2-request-spot-instance`: Use spot instances.
 - `--amazonec2-spot-price`: Spot instance bid price (in dollars). Require the `--amazonec2-request-spot-instance` flag.
 - `--amazonec2-private-address-only`: Use the private IP address only.
 - `--amazonec2-monitoring`: Enable CloudWatch Monitoring.

By default, the Amazon EC2 driver will use a daily image of Ubuntu 14.04 LTS.

| Region         | AMI ID       |
|----------------|--------------|
| ap-northeast-1 | ami-f4b06cf4 |
| ap-southeast-1 | ami-b899a2ea |
| ap-southeast-2 | ami-b59ce48f |
| cn-north-1     | ami-da930ee3 |
| eu-west-1      | ami-45d8a532 |
| eu-central-1   | ami-b6e0d9ab |
| sa-east-1      | ami-1199190c |
| us-east-1      | ami-5f709f34 |
| us-west-1      | ami-615cb725 |
| us-west-2      | ami-7f675e4f |
| us-gov-west-1  | ami-99a9c9ba |

Environment variables and default values:

| CLI option                          | Environment variable    | Default          |
|-------------------------------------|-------------------------|------------------|
| **`--amazonec2-access-key`**        | `AWS_ACCESS_KEY_ID`     | -                |
| **`--amazonec2-secret-key`**        | `AWS_SECRET_ACCESS_KEY` | -                |
| `--amazonec2-session-token`         | `AWS_SESSION_TOKEN`     | -                |
| `--amazonec2-ami`                   | `AWS_AMI`               | `ami-5f709f34`   |
| `--amazonec2-region`                | `AWS_DEFAULT_REGION`    | `us-east-1`      |
| **`--amazonec2-vpc-id`**            | `AWS_VPC_ID`            | -                |
| `--amazonec2-zone`                  | `AWS_ZONE`              | `a`              |
| `--amazonec2-subnet-id`             | `AWS_SUBNET_ID`         | -                |
| `--amazonec2-security-group`        | `AWS_SECURITY_GROUP`    | `docker-machine` |
| `--amazonec2-instance-type`         | `AWS_INSTANCE_TYPE`     | `t2.micro`       |
| `--amazonec2-root-size`             | `AWS_ROOT_SIZE`         | `16`             |
| `--amazonec2-iam-instance-profile`  | `AWS_INSTANCE_PROFILE`  | -                |
| `--amazonec2-ssh-user`              | `AWS_SSH_USER`          | `ubuntu`         |
| `--amazonec2-request-spot-instance` | -                       | `false`          |
| `--amazonec2-spot-price`            | -                       | `0.50`           |
| `--amazonec2-private-address-only`  | -                       | `false`          |
| `--amazonec2-monitoring`            | -                       | `false`          |