====== VirtualBox ======

!!Note: AstLinux 1.2.5 or later is required!!

**VM Host Specifications:**  [[https://www.virtualbox.org|VirtualBox]]

**AstLinux Board Type:**

  * "genx86_64" (VGA video console)
  * "genx86_64-vm" (VGA video console, including KVM and virtio drivers)

**VM Guest Recommended Options:**

  * Memory: 512 to 1024 MB
  * CPU: 2 Processor Cores
  * Virtual Storage: 4 to 8 GB
  * Network: Bridged Interface

**Configuration:**

Create a new Virtual Machine using "Expert Mode" ...

Specify Name, Type and Version. Set Memory size to 512 to 1024 MB:

{{:userdoc:guest_vm_virtualbox-start.jpeg?nolink|Start}}

Click "Create"...

Specify the Hard Disk size, the default is 8 GB, 4 GB should also work well for AstLinux.

{{:userdoc:guest_vm_virtualbox-hard-disk.jpeg?nolink|Hard Disk}}

Click "Create"...

The basic VM is finished, but we need to specify a few more configuration options.

Select "Settings" -> "Storage" and click on the "Empty" CD/DVD IDE optical drive:

Click on the the icon right of "Optical Drive: [ IDE Secondary Master ], then "Choose Virtual Optical Disk File..."

{{:userdoc:guest_vm_virtualbox-choose-optical.jpeg?nolink|Choose Disk}}

Select the downloaded "astlinux-NNN-genx86_64.iso" ISO file:

{{:userdoc:guest_vm_virtualbox-choose-image.jpeg?nolink|Choose Image}}

{{:userdoc:guest_vm_virtualbox-show-image.jpeg?nolink|Show Image}}

Click "OK"...

Select "Settings" -> "System" -> Processor, set 2 Processor CPUs:

{{:userdoc:guest_vm_virtualbox-cores.jpeg?nolink|Processors}}

Click "OK"...

Select "Settings" -> "Network" -> Adapter 1, set "Bridged Adapter":\\
(Use 'en0: Ethernet 1' for single interface host)

{{:userdoc:guest_vm_virtualbox-network.jpeg?nolink|Network}}

Click "OK"...

Select "Settings" -> "Audio", uncheck "Enable Audio":

{{:userdoc:guest_vm_virtualbox-disable-audio.jpeg?nolink|Disable Audio OS}}

Click "OK"...

Next, Install AstLinux, "Start" the VM, after a few seconds you should see the AstLinux Installer:

{{:userdoc:guest_vm_virtualbox-install-astlinux.jpeg?nolink|Install AstLinux}}

Select the "Install" installer menu, follow the dialogs to install an AstLinux image to your virtual disk.\\
When finished select the "Shutdown" installer menu.

After shutdown, Select "Settings" -> "Storage" and remove the AstLinux ISO from the optical drive:

{{:userdoc:guest_vm_virtualbox-eject-optical.jpeg?nolink|Remove CDROM}}

It should now show "Empty". Click "OK"...

Then "Start" the VM again:

{{:userdoc:guest_vm_virtualbox-astlinux.jpeg?nolink|AstLinux}}

Finally, configure AstLinux using the normal **[[userdoc:new-install|setup]]**.

!!Tip ->!! Note the "IPv4 Address:" on the screen and access the VM with SSH or an HTTPS browser on the same network.