2014-04-15 20:53:12 -04:00
page_title: Installation on Amazon EC2
2014-05-27 13:08:19 -04:00
page_description: Installation instructions for Docker on Amazon EC2.
2014-04-15 20:53:12 -04:00
page_keywords: amazon ec2, virtualization, cloud, docker, documentation, installation
# Amazon EC2
2014-12-04 07:26:36 -05:00
There are several ways to install Docker on AWS EC2. You can use Amazon Linux, which includes the Docker packages in its Software Repository, or opt for any of the other supported Linux images, for example a [*Standard Ubuntu Installation* ](#standard-ubuntu-installation ).
2014-04-15 20:53:12 -04:00
2014-04-23 16:48:28 -04:00
**You'll need an** [AWS account ](http://aws.amazon.com/ ) **first, of
2014-04-15 20:53:12 -04:00
course.**
2014-12-04 07:26:36 -05:00
## Amazon QuickStart with Amazon Linux AMI 2014.09.1
2014-04-15 20:53:12 -04:00
2014-12-04 07:26:36 -05:00
The latest Amazon Linux AMI, 2014.09.1, is Docker ready. Docker packages can be installed from Amazon's provided Software
2014-04-15 20:53:12 -04:00
Repository.
2014-04-23 16:48:28 -04:00
1. **Choose an image:**
- Launch the [Create Instance
Wizard](https://console.aws.amazon.com/ec2/v2/home?#LaunchInstanceWizard:)
menu on your AWS Console.
2014-12-04 07:26:36 -05:00
- In the Quick Start menu, select the Amazon provided AMI for Amazon Linux 2014.09.1
2014-04-23 16:48:28 -04:00
- For testing you can use the default (possibly free)
2014-12-04 07:26:36 -05:00
`t2.micro` instance (more info on
2014-04-23 16:48:28 -04:00
[pricing ](http://aws.amazon.com/ec2/pricing/ )).
- Click the `Next: Configure Instance Details`
button at the bottom right.
2. After a few more standard choices where defaults are probably ok,
your Amazon Linux instance should be running!
3. SSH to your instance to install Docker :
`ssh -i <path to your private key> ec2-user@<your public IP address>`
4. Once connected to the instance, type
2014-04-15 20:53:12 -04:00
`sudo yum install -y docker ; sudo service docker start`
to install and start Docker
2014-12-04 07:26:36 -05:00
**If this is your first AWS instance, you may need to set up your Security Group to allow SSH.** By default all incoming ports to your new instance will be blocked by the AWS Security Group, so you might just get timeouts when you try to connect.
Once you`ve got Docker installed, you're ready to try it out – head on
over to the [User Guide ](/userguide ).
2014-04-15 20:53:12 -04:00
## Standard Ubuntu Installation
If you want a more hands-on installation, then you can follow the
2014-12-15 23:25:37 -05:00
[*Ubuntu* ](/installation/ubuntulinux ) instructions installing Docker
on any EC2 instance running Ubuntu. Just follow Step 1 from the Amazon
QuickStart above to pick an image (or use one of your
2014-04-15 20:53:12 -04:00
own) and skip the step with the *User Data* . Then continue with the
2014-12-15 23:25:37 -05:00
[*Ubuntu* ](/installation/ubuntulinux ) instructions.
2014-04-15 20:53:12 -04:00
2014-05-21 17:05:19 -04:00
Continue with the [User Guide ](/userguide/ ).