Skip to main content

Create an Unraid USB drive

Unraid OS runs from a boot device. For a typical installation, this device is a USB flash drive. You can prepare it with our recommended Automated install method and the Unraid USB Creator, or use the Manual installation method.

Use a high-quality USB flash drive between 4 and 32 GB with a unique GUID. The GUID identifies the boot device for licensing.

Choosing reliable boot media

For typical USB installs, that means a quality USB flash drive; licensing depends on a unique GUID on the boot device. See Choosing a boot device in the manual install section for brand guidance and how to avoid counterfeits.

Automated install method​

The Unraid USB Creator prepares the drive, downloads or uses the selected Unraid OS image, and writes the image to the USB drive. Use this method for most new installations.

Writing erases the USB drive

The WRITE action erases the selected USB drive. Disconnect other removable drives before you start. If you are replacing an existing Unraid boot device, back it up first.

Download the USB Creator​

Download and install the USB Creator for your computer:

Insert the USB flash drive into your computer. Close any application that has the drive open.

Select the language​

  1. Open the USB Creator.
  2. Select your language.
  3. Select NEXT.

USB Creator language selection

Select an Unraid OS release​

  1. Select the Unraid OS release to install.
  2. Select NEXT.

For a production server, select the latest stable release. Use a development image only when you are testing that image.

USB Creator operating system selection

Select the USB drive​

  1. Select the USB drive that you want to prepare.
  2. Check the drive name, size, and GUID.
  3. Keep Exclude system drives selected.
  4. Select NEXT.

The GUID must be unique for the drive to work with Unraid licensing. Do not select a drive that contains data that you want to keep.

USB Creator storage device selection

Configure the new server (optional)​

The Customisation section lets you set these options before the first boot:

  • Server name sets the name that Unraid uses on your network.
  • Wi-Fi stores the Wi-Fi network settings for a server that uses a wireless connection.
  • Network sets automatic addressing with DHCP or a static IP address.

Skip these sections if you want to configure the server after the first boot. If you configure Wi-Fi, treat the USB drive as containing the Wi-Fi password until the server starts for the first time.

Review and write the image​

  1. Review the operating system and storage device in the summary.
  2. Make sure that the storage device is the USB drive that you want to erase.
  3. Select WRITE.

The USB Creator writes the selected image to the drive.

USB Creator write summary

Finish the USB setup​

When the write is complete:

  1. Review the choices shown on the completion screen.
  2. Select FINISH.
  3. Remove the USB drive only after the USB Creator ejects it.

UEFI systems can boot from the drive without any extra step. For an older BIOS-only system, run the boot script from the root of the USB drive:

  • Windows: Right-click make_bootable.bat and select Run as administrator.
  • macOS: Double-click make_bootable_mac and enter your administrator password when prompted.
  • Linux: Unmount the USB drive. Then run sudo bash ./make_bootable_linux.

USB Creator write complete

Boot the server from the new USB drive​

  1. Insert the prepared USB drive into the server.
  2. Open the server's BIOS or UEFI settings.
  3. Set the USB drive as the first boot device.
  4. Enable hardware virtualization features, including IOMMU. See HVM & IOMMU configuration for details.
  5. Save the BIOS settings and restart the server.

After Unraid OS starts, continue with Deploy and configure Unraid OS.

Troubleshooting​

The USB drive does not appear​

  1. Disconnect the USB drive.
  2. Close the USB Creator.
  3. Connect the USB drive directly to the computer.
  4. Open the USB Creator again.

The Unraid USB Creator only lists USB storage devices for this workflow. Make sure that your computer detects the drive before you open the USB Creator.

The server does not boot from the USB drive​

  1. Open the BIOS or UEFI settings.
  2. Make sure that the USB drive is the first boot device.
  3. For a BIOS-only system, run the platform-specific make_bootable script described in Finish the USB setup.
  4. Save the settings and restart the server.

If the server still does not boot, use the Manual install method to prepare the drive again.

The USB drive cannot register a license​

Unraid licensing requires a unique GUID. If the drive has no unique GUID, use a different USB flash drive. See Choosing a boot device for drive selection guidance.

Manual install method​

The manual installation method is designed for situations where the USB Flash Creator tool is either unavailable or incompatible with your hardware. This approach provides complete control over the formatting and setup process, making it ideal for advanced users or for troubleshooting specific issues with a USB device.

Choosing a boot device​

Unraid requires boot media with a unique hardware GUID. For USB boot, this is typically a USB flash drive. Drives that lack a unique GUID or reuse a GUID already registered to another user cannot be used with Unraid and may be blacklisted if they cause registration problems.

The most widely recognized brands, such as SanDisk, Kingston, and Samsung, are often counterfeited. Counterfeit drives frequently do not have a unique GUID, and some legitimate models from these brands have been reported to use non-unique identifiers. If you are unsure whether you are buying an authentic product from an authorized retailer, choosing a less-popular brand may actually be a safer option. These brands usually offer good-quality products but are less targeted by counterfeiters.

Brands often considered reliable by the community for having unique GUIDs (and generally less prone to counterfeiting) include:

  • TeamGroup
  • Transcend
  • PNY

Purchase from reputable retailers and avoid auction sites, unknown sellers, and second-hand or gray-market drives. For more information about SanDisk, see the forum PSA on counterfeit SanDisk USB drives.

Prepare your USB device​

  1. Plug in the USB drive you are preparing as the boot device.
  2. Format it to FAT32 (not ex-FAT or NTFS).
  3. Set the volume label to UNRAID (case-sensitive, all caps).
important

On Windows, drives larger than 32 GB cannot be formatted as FAT32 using the built-in formatting tools (they default to exFAT). For drives larger than 32 GB, you'll need to use a third-party tool like Rufus to format as FAT32.

Download and extract​

  1. Go to the Unraid Download Archive and download the ZIP file of your chosen release.
  2. Extract the ZIP contents to the USB device.
  3. Confirm that the files have been copied.

Make the USB device bootable​

note

This section is only needed to enable Legacy boot. If setting up for UEFI boot, there is no need to run these scripts.

Run the appropriate script for your OS:

Windows 7 or later:

  • Right-click make_bootable and select Run as administrator.

Mac:

  • Double-click make_bootable_mac and enter your admin password.

Linux:

  • Copy make_bootable_linux to your hard drive.

  • Unmount the USB drive.

  • In the terminal, run:

    sudo bash ./make_bootable_linux
note

The USB drive may briefly disappear and reappear a few times during this process. This is normal.