AWS quick start
Quick start

OneView documentation

AWS quick start

Launch an EC2 instance and install OneView with automatic HTTPS.

1. Launch an EC2 instance

Launch an instance using Ubuntu 24.04 LTS. Use at least 2 vCPU and 4 GiB RAM with 20 GiB of storage; 4 vCPU and 8 GiB are recommended. Attach a key pair so you can reach the instance's shell.

2. Open the network path

Add inbound rules to the instance's attached Security Group allowing TCP 80 and TCP 443 from 0.0.0.0/0 (and ::/0 if the instance also has an IPv6 address).

This quick start uses automatic HTTPS, which requests a Let's Encrypt certificate over port 80. Leaving only port 443 open is a common mistake for customers who already hold an AWS Certificate Manager (ACM) certificate — port 80 must also be open even though the certificate itself comes from Let's Encrypt, not ACM.

ACM certificates cannot be used by this installer's self-hosted gateway. ACM never exposes the certificate's private key outside AWS-native services (such as an Application Load Balancer), so the installer has no way to load an ACM certificate directly. If the organisation specifically wants to use an existing ACM certificate, put an Application Load Balancer that terminates TLS with that certificate in front of the instance and follow External reverse proxy instead of this page.

Allocate an Elastic IP and associate it with the instance so the public address used for DNS does not change if the instance stops and starts.

3. Point DNS

Create a DNS A record for the chosen hostname pointing at the Elastic IP from the previous step, then confirm it resolves:

dig +short oneview.customer.example

4. Install Docker

Connect to the instance's shell, then install Docker Engine from the official apt repository:

sudo apt-get update
sudo apt-get install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update

sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Confirm the installed versions meet the requirements baseline (Docker Engine 24.0.0+, Docker Compose 2.20.0+):

docker version --format '{{.Server.Version}}' && docker compose version

5. Continue with the standard installer

The host is now ready. Continue from step 2 of the installation quick start to create the installation directory, run the installer, and complete browser setup.