Your first Ubuntu image¶

This tutorial will walk you through creating your first Ubuntu image and launching it in a virtual machine.

Install dependencies¶

sudo apt-get update
sudo apt-get install git snapd qemu-user-static ubuntu-dev-tools
sudo snap install --classic ubuntu-image

Clone the gadget repository¶

Note

The main branch should contain a gadget targetting current Ubuntu development release. LTS branches like resolute and noble are available (add -b <branch> to the command below).

If the target hardware does not support the RVA23 profile, noble is the only possible option, as resolute and above require RVA23.

git clone https://github.com/canonical/risc-v-gadget.git

Build the image¶

cd risc-v-gadget
sudo ubuntu-image --workdir workdir --debug classic image-definition.yaml

Test the image¶

Navigate to the image and change the owner.

cd workdir
sudo chown $USER ubuntu-*-preinstalled-server-riscv64.img

See Install Ubuntu on QEMU (RISC-V). for the command to launch the virtual machine.

You will be asked to change the password.

Power off the virtual machine with

sudo poweroff