Welcome to the IPFire Wiki

This wiki is a community-maintained resource about everything there is to know about IPFire.

Please join in and help us improving it!

Differences in Revisions: VirtualBox Setup

Older Revision
August 13 at 2:17 am
»
Newer Revision
August 13 at 2:21 am
update
# VirtualBox Setup
 
 
## Requirements
The prerequisites for installing IPFire in a virtual machine are very simple. You need a working operating system and software to create and operate a virtual machine. In this wiki VirtualBox is used. [VirtualBox](https://en.wikipedia.org/wiki/VirtualBox) can be downloaded for free at [Download VirtualBox](https://www.virtualbox.org/wiki/Downloads). The operation is similar for Linux and Windows but the installation is a bit different. For more information please refer to the documentation of VirtualBox:
 
* [Online User Manual](https://www.virtualbox.org/manual/UserManual.html)
* [PDF version User Manual](http://download.virtualbox.org/virtualbox/UserManual.pdf)
 
Install the VirtualBox application per the instructions in Oracle VM VirtualBox User Manual.
 
**Note:** Images below are from macOS VirtualBox version 5.2.18.
 
 
## Configuration
Launch the VirtualBox application.
 
Click on "New" to create a new virtual machine.
![](/virtualization/virtualbox/vb_new.png)
 
A wizard can guide you through setting up a new virtual machine (VM). The images below are from the **Expert Mode**.
 
**Name and operating system**
Enter the name for the virtual machine (e.g., **IPFireVM**). For "Type" select **Linux**. For "Version" pick the line that includes **Linux 4.x (64-bit)**.
 
**Memory size**
Select the memory (RAM) that VirtualBox should allocate for IPFire. The VirtualBox default is 1024 MB and **2048 MB** was chosen in this example.
 
**Hard disk**
To specify a virtual hard disk for the VM choose **Create a virtual hard disk now**.
 
![](/virtualization/virtualbox/vb_name_mem_disk.png)
 
Click "Create" (or "Continue" in the guided/wizard mode).
 
----
 
**File location**
Add a file name (e.g., **IPFireVM**) and a file location (if needed).
 
**File size**
Select the maximum virtual hard disk file size. **8.00 GB** was chosen in the example.
 
**Hard disk file type**
Click **VDI (VirtualBox Disk Image)**.
 
**Storage on physical hard disk**
Click **Fixed size**.
![](/virtualization/virtualbox/vb_file_loc_size_type.png)
 
 
Click "Create" (or "Continue" in the guided/wizard mode).
 
Many of the above settings can be changed as long at this virtual machine is Powered Off (not running).
 
 
## Network
Note: This is how I setup network connections for my VM test system. It may not be how you wish to proceed.
 
![](/virtualization/virtualbox/ipfire_network_w_vb_vm_v2.png)
 
My <span style="color:red">IPFireVM red network</span> is connected to my local network. So for me:
My <span style="color:red">IPFireVM red network</span> is connected to my local network.
 
Adapter 1 = <span style="color:red">IPFireVM red network</span> = local network.
* So for me: **Adapter 1 = <span style="color:red">IPFireVM red network</span> = local network.**
![](/virtualization/virtualbox/vb_network_adapter1.png)
 
Make note of the **MAC address** for this adapter. It will be needed for the IPFire installation.
 
----
 
My <span style="color:green">IPFireVM green network</span> is connected to a USB to Ethernet adapter and that adapter is connected to a stand-alone computer. So my setup is:\\
My <span style="color:green">IPFireVM green network</span> is connected to a USB to Ethernet adapter and that adapter is connected to a stand-alone computer.
 
Adapter 2 = <span style="color:green">IPFireVM green network</span> = stand alone computer.
* So my setup is: **Adapter 2 = <span style="color:green">IPFireVM green network</span> = stand alone computer.**
![](/virtualization/virtualbox/vb_network_adapter2.png)
 
Make note of the **MAC address** for this adapter. It will be needed for the IPFire installation.
 
## IPFire Install
 
Obtain the IPFire image from [IPFire downloads](https://www.ipfire.org/download). Locate the **x86_64** heading and click on the **ISO Image** to download the needed file.
 
This virtual machine uses the **x86_64** image and **not** the i586 or arm images.
 
Click **Settings**
![](/virtualization/virtualbox/vb_settings.png)
 
Click **Storage**, then click on the **Empty** CD, and then enable **Live CD/DVD**. Now click on the CD ![](/virtualization/virtualbox/vb_settings_storage_cd.png), click **Choose Virtual Optical Disk File**, locate the IPFire image (e.g., ipfire-2.21.x86_64-full-core123.iso) in your Downloads folder. Click **OK** to exit the Storage Settings.
![](/virtualization/virtualbox/vb_settings_storage.png)
 
The virtual machine will be configured similar to this:
![](/virtualization/virtualbox/vb_vm_virtualbox_mgr.png)
 
Click **Start**
![](/virtualization/virtualbox/vb_ipfire_install.png)
 
And then begin to follow the steps [here](/installation).
***Important!***
Make sure you remove the CD after installing IPFire.\\
Go to Settings > Storage and click on the CD ![](/virtualization/virtualbox/vb_settings_storage_cd.png), click **Remove Disk from Virtual Drive**.
 
## External Links:
* [VirtualBox](https://en.wikipedia.org/wiki/VirtualBox)
* [VirtualBox Online User Manual](https://www.virtualbox.org/manual/UserManual.html)
* [VirtualBox User Manual (PDF version)](http://download.virtualbox.org/virtualbox/UserManual.pdf)
* [Changelog for VirtualBox](https://www.virtualbox.org/wiki/Changelog)
* [Oracle VM VirtualBox: Networking options and how-to manage them](https://blogs.oracle.com/scoter/networking-in-virtualbox-v2)
* [VirtualBox User Manual: Chapter 6 - Virtual networking](https://www.virtualbox.org/manual/ch06.html)