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

VirtualBox Setup


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 can be downloaded for free at Download VirtualBox. 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:

Install the VirtualBox application per the instructions in Oracle VM VirtualBox User Manual.

Note: Images below are from macOS VirtualBox version 5.2.18.


Launch the VirtualBox application.

Click on "New" to create a new virtual machine.

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.

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.

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).


Note: This is how I setup network connections for my VM test system. It may not be how you wish to proceed.

My IPFireVM red network is connected to my local network.

  • So for me: Adapter 1 = IPFireVM red network = local network.

Make note of the MAC address for this adapter. It will be needed for the IPFire installation.

My IPFireVM green network is connected to a USB to Ethernet adapter and that adapter is connected to a stand-alone computer.

  • So my setup is: Adapter 2 = IPFireVM green network = stand alone computer.

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. 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

Click Storage, then click on the Empty CD, and then enable Live CD/DVD. Now click on the CD

, 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.

The virtual machine will be configured similar to this:

Click Start

And then begin to follow the steps here.
Make sure you remove the CD after installing IPFire.\
Go to Settings > Storage and click on the CD

, click Remove Disk from Virtual Drive.

Edit Page ‐ Yes, you can edit!

Older Revisions • August 13 at 2:21 am • Jon