Virtual Machine (VM)

A how-to on the process of installing TrueNAS into a VM.

  3 minute read

TrueNAS can be installed inside a virtual machine using an .iso file. To get the latest version of TrueNAS go to the TrueNAS website and download TrueNAS Core. The next step is to install it into a VM.

Virtual Machine Application

Since TrueNAS is built and provided as an .iso file, it will work on all virtual machine applications (VMware, VirtualBox, Citrix Hypervisor, etc). In this document, VMware Workstation Player for Windows is being used.

When installing TrueNAS in a VMware VM, double check the virtual switch and VMware port group. Network connection errors for plugins or jails inside the TrueNAS VM can be caused by a misconfigured virtual switch or VMware port group. Make sure MAC spoofing and promiscuous mode are enabled on the switch first, and then the port group the VM is using.


NOTE: VMware Player 15.5 for Windows is being used in this example.

Open VMware Player and click Create a New Virtual Machine to enter the New Virtual Machine Wizard.

1. Installer disk image file

Select the Installer disk image file (iso) option, click Browse…, and upload the TrueNAS Core .iso file that was downloaded earlier.

2. Name the Virtual Machine

In this step, the virtual machine name and location can be changed.

3. Specify Disk Capacity

Specify the maximum disk size for the initial disk. The default value of 20GB is enough for TrueNAS. Next, select Store virtual disk as a single file.

4. Review Virtual Machine

Review the virtual machine configuration before proceeding. By default, VMware Player doesn’t set enough RAM for the virtual machine. Click Customize Hardware… > Memory. Drag the slider up to 8GB and click Ok. If you wish to power on the machine after creation, select Power on this virtual machine after creation.

Add Virtual Disk for Storage

After the virtual machine has been created, select it from the virtual machine list and click Edit virtual machine settings. Click Add… and select Hard Disk. Select SCSI as the virtual disk type. Select Create a new virtual disk. Specify the maximum size of this additional virtual disk. This disk will be used for data storage. If desired, allocate the disk space immediately by setting Allocate all disk space now. Select Store virtual disk as single file. Finally, name and chose a location for the new virtual disk.

TrueNAS Installer

Select the virtual machine from the list and click Play virtual machine. The machine will start and boot into the TrueNAS installer. Select Install/Upgrade.

Select the desired disk for the boot environments.

Select Yes. This will erase all contents on the disk!

Set a password for root login.

Select <Boot via BIOS>.

After the installation of TrueNAS has completed, reboot the system. Congratulations, TrueNAS is now installed in a virtual machine.

Last modified July 21, 2020: Rename `docs/` dir test (3b998b7f)