= Running in !VirtualBox =
[[PageOutline]]

This page describes how to use [http://www.virtualbox.org/ VirtualBox] to run various HelenOS images you either [http://www.helenos.org/download downloaded] or [wiki:UsersGuide/CompilingFromSource 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 [wiki:UsersGuide/Networking].

See [http://www.virtualbox.org/manual/ch06.html 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 [wiki:RunningInQEMU#Networking 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