Using the Amazon AMI¶
To make installation easier, we provide an packer build that creates an Amazon Machine Image (AMI). This AMI is built from an Ubuntu 16.04 LTS image, and is HVM based. While our ultimate plan is to provide this AMI on the AWS Marketplace, we don’t have this set up yet.
Building an AMI¶
Note
The build script that runs packer requires you to have python installed locally.
1. Install Packer¶
If you haven’t already, install packer using their documentation here. We recommend using homebrew for the installation if you’re using OSX.
2. Accept License¶
Before building with packer, you must accept the license agreement for the base Ubuntu AMI: https://aws.amazon.com/marketplace/pp/B01JBL2M0O
3. Clone Repository¶
git clone https://github.com/stackdio/stackdio.git
cd stackdio
4. Export AWS Credentials¶
Ensure packer knows about your aws credentials:
export AWS_ACCESS_KEY='<YOUR_ACCESS_KEY>'
export AWS_SECRET_KEY='<YOUR_SECRET_KEY>'
5. Run the packer build¶
Finally, run the packer build, where <version>
is the version you want to build:
./packer/build.py <version>
After a few minutes, you should have a usable AMI.
Using the AMI¶
After you’ve built the AMI, you can launch an instance from it.
Once the instance is running, you can navigate to http://<instance-ip>/
and login using the following credentials:
username: admin
password: stackdio
We recommend changing this password immediately after logging in the first time.