Template:Install LuneOS Emulator

= Overview =

We're providing a emulator with the LuneOS project which enables you to play with the system on your local PC without the need to use a target device. The base for the emulator is Virtual Box.

= Installation =

First you need to download the emulator image. Currently we don't have an update mechanism implemented so you have to download and update your virtual machine on your own.

You will find the appliances for Virtual Box at http://build.webos-ports.org/luneos-stable/images/qemux86/ (32 bits) or http://build.webos-ports.org/luneos-stable/images/qemux86-64/ (64 bits). The archives are prefixed with webos-ports-dev-emulator-qemux86 (32 bits) and webos-ports-dev-emulator-qemux86-64 (64 bits). If you want to use always the latest image you can just use http://build.webos-ports.org/luneos-testing/images/qemux86/webos-ports-dev-emulator-qemux86.zip (32 bits) or http://build.webos-ports.org/luneos-testing/images/qemux86-64/webos-ports-dev-emulator-qemux86-64.zip (64 bits) which always points to the latest image.

Please note that the mouse and keyboard for the 64 bits version are broken currently, please use the 32 bits version for now!

As next step you need to download and install Virtual Box. Please see https://www.virtualbox.org/ for any further details.

After you've installed Virtual Box you need to extract the downloaded emulator archive. It contains two files (webos-ports-emulator-disk.vmdk and webos-ports-emulator.ovf) which needs to be placed within the same directory. Now the appliance can be imported into Virtual Box. Start Virtual Box and select "File -> Import Appliance" from the application menu. In the following dialog select the extracted file webos-ports-emulator.ovf as the appliance to import and just follow the wizard. You don't need to change any of the preconfigured values. After the appliance was successfully imported you can start the emulator as any other virtual machine inside Virtual Box.

= Access the virtual machine with SSH =

The emulator has been configured to forward the port 22 (the port SSH is listening on) to the port 5522 of your PC. You can connect with SSH by running

ssh -p 5522 root@localhost

on the command prompt of your Linux system or by using Putty on Windows.