Skip to main content

Provision

This guide will walk you through the process of provisioning a Raspberry Pi 4 Model B using the Avocado CLI. For general information on provisioning, see the provisioning reference.

Prerequisites​

  • A Linux host machine per reliable provisioning:
    • Ubuntu 22.04+, Fedora 39+
  • Available disk space: 8 GB
  • A TTY serial console USB adapter to connect to the device's serial console for monitoring and debugging.
  • The latest version of the Avocado CLI.

Initialize project​

Create the project directory and install dependencies.

Host machine
avocado init --target raspberrypi4 raspberrypi4 && cd raspberrypi4
avocado install --force

Set up serial console​

Connect your TTY serial console USB adapter to the device's serial console port. This will allow you to monitor the boot process and access the device console.

Use a serial terminal program like screen or tio to connect. The typical connection settings are:

Example using tio:

Host machine
tio -b 115200 /dev/ttyUSB0

Replace /dev/ttyUSB0 with the appropriate device path for your serial adapter.

Provision​

Build the project and execute the provisioning procedure. This will build the system image and flash it to your target hardware.

Host machine
avocado build
avocado provision -r dev --provision-profile sd

Run​

After provisioning completes, insert the SD card into your target device and power it on.

The device will boot from the SD card with the provisioned system. The root user is passwordless in the dev runtime used by this guide.