Installing TrueNAS for the First Time

How to obtain and install TrueNAS on physical hardware.

  6 minute read

Hardware Requirements

The following is a list of minimum hardware requirements to install and run TrueNAS. It is recommended to examine your specific storage and sharing requirements and install TrueNAS on hardware that exceeds these requirements, to best meet your performance needs.

  • RAM: An absolute minimum of 8GB of RAM is required to run TrueNAS. When your system will have more than 8 storage drives, add an additional 1 Gb of RAM for each additional drive. For example, a TrueNAS system that has 12 storage drives will need 12 Gb of RAM, at minimum.

  • Operating system device: The TrueNAS operating system requires 8 GB of space on a device that is separate from the storage disks. It is strongly recommended to use a 16 GB or greater SSD or hard drive for the operating system. It is not recommended to use a USB stick as a boot device because the build quality or device lifetime varies too much to reliably use as the operating system device.

  • Storage disks and controllers: TrueNAS supports hot-pluggable SATA drives when AHCI is enabled in the BIOS. TrueNAS is predominantly tested using Western Digital hard drives. Therefore, we recommend WD Red Plus drives when the system has fewer than 8 storage drives, WD Red Pro drives when the system has 8-16 drives, and WD Ultrastar drives for systems with more than 16 storage drives. Always make sure to use a hard drive with conventional magnetic recording (CMR) techology and avoid drives with shingled magnetic recording (SMR) technology for best results with TrueNAS and OpenZFS. A list of supported disk controllers is found in the FreeBSD Hardware Notes.

  • Network Interfaces: The Ethernet section of the FreeBSD Hardware Notes indicates which interfaces are supported by each driver. We recommend using Intel or Chelsio interfaces for best performance.

BIOS Settings for AMD Ryzen processors

If the system that will have TrueNAS installed uses an AMD “Zen” processer, you might want to update your motherboard BIOS or change a few settings before starting the installation process.

First Generation Zen Processors

Community members have reported a stability issue on 1st Generation AMD Ryzen processors that does not appear to occur with later generation processors.

Fixes reported by the community are:

  • Updating the motherboard BIOS according to the manufacturer recommendations
  • Disabling CoolNQuiet
  • Disabling C-States in the BIOS

Second Generation Zen+ Processors

Community members have reported a stability issue on 2nd Generation AMD Ryzen “Zen+” processors that does not appear to occur with later generation processors.

Fixes reported by the Community are:

  • Updating the motherboard BIOS according to the manufacturer recommendations
  • Disabling C6 in the BIOS

Preparing the Install Media

The latest STABLE version of TrueNAS CORE can be downloaded from Open the link and click Download Now to save the TrueNAS installer .iso file to your local system.

The TrueNAS installer can be run from a CD or USB stick. The method of writing the installer to a device varies between operating systems. The following sections explain how to write the installer when you have either Windows or a generic Linux operating system installed.

To use the installer with a CD, download your favorite CD burning utility and burn the .iso file to the CD. Then insert the CD into the TrueNAS system and boot from the CD.


To write the TrueNAS installer to a USB stick on Windows, plug the USB stick into the system and use Rufus to write the .iso file to the memory stick. When Rufus prompts for which write method to use, please ensure that “dd mode” is selected.

The USB stick will not be recognized by Windows after the TrueNAS installer has been written to it. To reclaim the USB stick after installing TrueNAS, use Rufus to write a “Non bootable” image, then remove and reinsert the USB stick.


To write the TrueNAS installer to a USB stick on Linux, plug the USB stick into the system and open a terminal. First, make sure the USB stick connection path is correct. There are many ways to do this in Linux. Type

lsblk -po +vendor,model
and note the path to the USB stick, shown in the NAME column of lsblk.

Next, use dd to write the installer to the USB stick. Type

dd status=progress if=path/to/.iso of=path/to/USB
in the CLI. If this results in a “permission denied” error, use sudo dd with the same parameters and enter your administrator password. Be very careful when using dd, as choosing the wrong “of=” device path can result in irretrievable data loss!

Installing TrueNAS

With the installer added to a device, you can now install TrueNAS onto the desired system. Insert the install media and reboot or boot the system. At the motherboard splash screen, use the hotkey defined by your motherboard manufacturer to boot into the motherboard UEFI/BIOS.

Choose to boot in UEFI mode or legacy CSM/BIOS mode. When installing TrueNAS, make the matching choice for the installation. For Intel chipsets manufactured in 2020 or later, UEFI is likely the only option.

If your system supports SecureBoot, you will need to either disable it or set it to “Other OS” to be able to boot the install media.

Select the install device as the boot drive, exit, and reboot the system. If the USB stick is not shown as a boot option, try a different USB slot. Which slots are available for boot differs by hardware.

After the system has booted into the installer, follow these steps.

Select Install/Upgrade.

Select the desired install drive.

Select Yes

Select Fresh Install to do a clean install of the downloaded version of TrueNAS. This will erase the contents of the selected drive!

When the operating system device has enough additional space, you can choose to allocate some space for a swap partition to improve performance.

Enter a password for the root user to log in to the web interface.

After following the steps to install, reboot the system and remove the install media.

Congratulations! TrueNAS is now installed.

The next steps are to either wait for the system to boot and access the web interface or boot the system and configure the console setup menu.

Installation Troubleshooting

If the system does not boot into TrueNAS, there are several things that can be checked to resolve the situation:

  • Check the system BIOS and see if there is an option to change the USB emulation from CD/DVD/floppy to hard drive. If it still will not boot, check to see if the card/drive is UDMA compliant.
  • If the system BIOS does not support EFI with BIOS emulation, see if it has an option to boot using legacy BIOS mode.
  • If the system starts to boot but hangs with this repeated error message: run_interrupt_driven_hooks: still waiting after 60 seconds for xpt_config, go into the system BIOS and look for an onboard device configuration for a 1394 Controller. If present, disable that device and try booting again.
  • If the burned image fails to boot and the image was burned using a Windows system, wipe the USB stick before trying a second burn using a utility such as Active@ KillDisk. Otherwise, the second burn attempt will fail as Windows does not understand the partition which was written from the image file. Be very careful to specify the correct USB stick when using a wipe utility!