Booting the Raw eLxr Edge Image¶

About This Task¶

Once you create a raw image with the rucksack Docker container, you can boot it as described in this procedure.

Before You Begin¶

You must have a previously built raw eLxr image. For details, see Creating the Raw eLxr Edge OSTree Image.
You must have the qemu, qemu-kvm, virt-manager, and bridge-utils packages installed on your development host.
You must have a VNC client, such as Remmina or its equivalent.

Procedure¶

Boot the eLxr raw image. For the -vnc option, specify an available port. This example uses :0, which represents port 5900.

$ sudo qemu-system-x86_64 -enable-kvm -m 4G -bios /usr/share/qemu/OVMF.fd \
-drive file=elxr-minimal-ostree-amd64-12.10.0.0-amd64.img,media=disk,format=raw -vnc :0

Obtain the IP address for your host system using the ip command, for example ip address. You will need the address associated with your Ethernet connection.
Using your VNC client, connect to the image deployed in step 1. This example uses port :5900. Ensure this port matches the one specified in step 1.
```
$ remmina -c vnc://root@<your-ip-address>:5900
```

In the VNC viewer window, enter root for the user name and password to log in.

    localhost login: root
    Password:
    Linux localhost 6.1.0-32-amd64 #1 SMP PREEMPT_DYNAMIC eLxr
6.1.129 elxr3-1 (2025-05-21) x86_64


    The programs included with the eLxr Linux system
    are free software;
    the exact distribution terms for each program are described in the
    individual files in /usr/share/doc/*/copyright.

    eLxr Linux comes with ABSOLUTELY NO WARRANTY,
    to the extent permitted by applicable law.

Optionally navigate the file system.

root@localhost:~# ls /

bin   efi   initrd.img      lib64       mnt   root  srv  usr      vmlinuz.old
boot  etc   initrd.img.old  lost+found  opt   run   sys  var
dev   home  lib             media       proc  sbin  tmp  vmlinuz

Results¶

Now that you have a running eLxr 12 instance, you can view and add additional packages from the eLxr repository. For details, see eLxr 12 Quick Start: Adding and Updating Packages.