Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
Running OSv on EC2
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.
- launch an AMI
- Select instance type
- Proceed (Next) to set Configure Instance Details.
- Proceed (Next) to set Add Storage.
- Proceed (Next) to set Tag Instance.
- Proceed (Next) to set Security Group. Make sure to enable SSH on port 22.
- click Review and Launch.
- click Launch.
- 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 release-ec2.sh script found under the scripts directory. For the different options call
Note that only raw image format is supported on EC2. so make sure to compile with