Skip to main content

Ubuntu Virtual Machine

The verified build server runs Ubuntu 20.04.5 LTS amd64. Ubuntu 20.04.x 64-bit Desktop is therefore recommended when environment compatibility is the priority.

Obtain the Ubuntu ISO​

The internal file share may provide multiple Ubuntu ISO images.

Ubuntu ISO images on the file share

An ISO may also be downloaded from an official or trusted mirror. Select the required release and download a file containing:

desktop-amd64.iso

Ubuntu mirror release index

Selecting the Ubuntu Desktop ISO

Create the Virtual Machine​

Click “Create a New Virtual Machine” and select the typical configuration.

Selecting the typical VM configuration

Select the downloaded Ubuntu ISO.

Selecting the Ubuntu ISO

Enter a normal user name and password. Do not use the root account for daily builds.

Entering Ubuntu account information

Set the VM name and storage location. Large SDK trees should be placed on a sufficiently large SSD.

Setting the VM name and location

The original 4 GB RAM and 40 GB disk screenshots demonstrate the UI only. They are not sufficient for complete Android, Rockchip, or Allwinner SDK builds.

ResourceMinimum RecommendationPreferred
CPU4 cores / 8 threads8 cores / 16 threads or more
RAM16 GB32 GB or more
System and tools disk100 GB150 GB or more
SDK workspace300 GB500 GB to 1 TB
StorageSATA SSDNVMe SSD

Allocate enough virtual disk space.

Setting virtual disk capacity

Open the hardware customization page.

Customizing VM hardware

Do not assign all host memory to the VM.

Configuring VM memory

Use Windows Task Manager to inspect the host resources.

Inspecting host resources

The configured virtual CPU count must not exceed the host's available logical processors.

Configuring virtual CPUs

Network Mode​

Bridged mode is useful when other LAN devices must access the VM directly. NAT is usually simpler when only outbound Internet access is required.

Configuring bridged networking

Confirm the VM configuration and start installation.

VM configuration summary

Ubuntu installation screen

Log in using the normal account created during setup.

Ubuntu login screen