Running on QEMU

If you want to execute the image without building first, grab the latest release or build artifacts from https://github.com/eclipse-leda/leda-distro/

Recommendations

  • A Linux host with 8 vCPUs, 16GB of RAM and SSD storage is recommended
  • Your Linux user should be sudoer to allow TAP network interfaces to be set up

QEMU x86_64

  • Install Qemu, e.g. for Ubuntu:

    sudo apt-get update -y
    sudo apt-get install -y xz-utils qemu-system-x86-64
    
  • Download latest Eclipse Leda release

  • Uncompress the archive

    tar xf eclipse-leda-qemu-x86_64.tar.xz
    
  • Run QEMU on Linux:

    ./run-leda.sh
    
  • Run QEMU on Windows:

    run-leda.cmd
    

    Leda boot sequence

  • Login as root without password on login prompt

  • Verify and wait until container runtime is started: systemctl status container-management

  • Optional: Check the system health: sdv-health

    sdv-health

    Note: The status of some containers (e.g. cloud connector) are expected to stay in FAILED status as long as the Device Provisioning steps are not completed.

  • Continue with Device Provisioning

QEMU ARM 64-Bit

  • Install Qemu, e.g. for ARM 64-Bit: sudo apt install qemu-system-aarch64

  • Download latest Eclipse Leda release

  • Uncompress the archive

    tar xf eclipse-leda-qemu-arm64.tar.xz
    
  • Run QEMU on Linux:

    ./run-leda.sh
    
  • Run QEMU on Windows:

    run-leda.cmd
    
  • Login as root without password on login prompt

  • Verify and wait until container runtime is started: systemctl status container-management

  • Optional: Check the system health: sdv-health

    Note: The status of some containers (e.g. cloud connector) are expected to stay in FAILED status as long as the Device Provisioning steps are not completed.

  • Continue with Device Provisioning