Welcome to the IPFire Wiki

This wiki is a community-maintained resource about everything there is to know about IPFire. Join us and help us improving it!

Looking for something?

Use the search and find answers to everything about IPFire. If you cannot find what you are looking for, join our community and talk to fellow IPFire users, developers and everybody else involved in the project.

IPFire Community

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)