Running in VirtualBox

This page describes how to use ​VirtualBox to run various HelenOS images you either downloaded or built yourself.

Basics

To run ia32 or amd64 HelenOS, configure a virtual machine that boots from the ISO image.

Note: Some Ubuntu provided versions of VirtualBox don't seem to work with HelenOS ISO images. Try running with vanilla VirtualBox instead.

Serial ports

TODO write this section

Networking

For general information about networking in HelenOS, please see UsersGuide/Networking.

See ​VirtualBox manual for more information on networking in VirtualBox.

In order to use networking in HelenOS running under VirtualBox, the guest needs to have at least one Network Adapter enabled in Network configuration menu. Note that VirtualBox supports several networking cards, but out of these, HelenOS has driver only for the Intel PRO/1000 variants.

Being based on the QEMU networking code, VirtualBox provides similar networking options as QEMU, namely in the NAT and Bridged mode. The difference is that VirtualBox provides easy to use configuration GUI and saves the user from fiddling with the host setup, so that especially the Bridged mode is much easier to use. In the NAT mode, the respective guest network interface will be behind a NAT firewall provided by VirtualBox. The NAT mode is essentially the same as QEMU user networking with port forwarding, including the assigned addresses and limitations. To use the network adapter in the NAT mode, simply select NAT in the Attached to: menu. Note that NAT is the default mode.

In the Bridged mode, VirtualBox arranges for a setup, in which the HelenOS guest will be on the same network as the host itself. What is nice about this mode is that it works out of the box and no special setup is required. Just select Bridged Adapter in the Attached to: menu.

USB

TODO write this section