From WebOS-Ports
Revision as of 09:25, 2 September 2014 by Ktk (talk | contribs) (Updated links to correct LuneOS locations)
Jump to navigation Jump to search


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


First you need to download emulator. 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.

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.