Running OSv on EC2

James Fu edited this page May 19, 2015 · 19 revisions
Clone this wiki locally

EC2 modes of operation

Since it is based on Xen, EC2 has two modes of operation: Paravirtualization (PV), and Hardware assisted Virtualization (HVM). PV is a work in progress, and actually quite exciting to work with but it currently cannot boot. You are welcome to help by Forking us on github. Here, we will tell you how to run HVM images.

Preparation of HVM Images

However possible to run native Linux HVM images, it is a lot easier to adapt Microsoft Windows images, which is what we do. You can build your own custom OSv image and upload it into EC2, merely replacing the disk of a Windows VM with an OSv disk. Instructions on how to do this will be available soon.


For direct links to latest OSv AMI list: Latest-EC2-AMI-list

For other versions, go to EC2, click the Community AMIs tab, and look for OSv. Choose your favorite OSv Virtual Appliance and version.

  1. launch an AMI
  2. Select instance type
  3. Proceed (Next) to set Configure Instance Details.
  4. Proceed (Next) to set Add Storage.
  5. Proceed (Next) to set Tag Instance.
  6. Proceed (Next) to set Security Group. Make sure to enable SSH on port 22.
  7. click Review and Launch.
  8. click Launch.
  9. create a new key-pair or use an existing one

You are good to go!

  • Launch your instance
  • Click "Instances" to watch the new OSv instance status: Once it move to state "running" you can connect to it.
  • Copy the public DNS name available on the instance dashboard.

Managing a running instance

Remote management of an OSv instance is done via OSV Rest API

OSv provides two management tools that utilize OSv Rest API:

You can secure remote management of an instance by: configuring SSL via cloud init.

  • Connecting to a secured OSv instance Dashboard requires additional browser configuration
  • Connecting to a secured OSv via CLI over HTTPS requires additional params

Creating your own Image

To upload your own image, use the script found under the scripts directory. For the different options call

scripts/ --help

Note that only raw image format is supported on EC2. so make sure to compile with

make img_format=raw