Unraid 6/Frequently Asked Questions

From unRAID
Revision as of 07:01, 6 February 2019 by Jonp (talk | contribs)
Jump to: navigation, search

Pre-sales

Is pricing for Unraid OS "one time"? Is there any fee for updates?

Unraid OS registration key pricing reflects a one-time fee for “Unraid OS” and updates are included. Pretty great deal, right?

What happens when my USB fails? Do I have to repurchase my registration key?

If your USB Flash boot device fails, you can transfer your registration key to a new USB Flash device initially at any time, and subsequently up to once per year. Here's a link on how to do that: https://wiki.unraid.net/UnRAID_6/Changing_The_Flash_Device

I need help with a build / system configuration. Where do I go?

For assistance with creating a special build for Unraid OS, we highly advise users to check out our Compulsive Design forum. Our community is fantastic about helping folks create their ultimate Unraid system.

Can you guys recommend any storage controllers (or other hardware) for my build?

It is our general policy to not recommend specific hardware to end users. There is so much hardware out there to choose from that we couldn't possibly test it all, but thanks to our friendly community, most users have tried almost everything that's out there, so if you need a recommendation, check the forums!

Troubleshooting and Support

My USB flash has failed and I don't have a backup. How do I restore my configuration?

First and foremost, you'll need to get a new flash device. Remember to get something of quality (Kingston, PNY, Lexar, and SanDisk are a few brands we've had good success with). Second, you'll need to find the e-mail with your registration key for your previous flash device. Last, you'll need to install Unraid on the new flash device, boot it up on your server, and then install the old registration key on the new flash (from the Tools > Registration page). From there you can request and then install a replacement key.

As far as your configuration goes, if you can remember your drive assignments (which disks were assigned to which slots), you should be able to simply re-assign them all and start the array. You may need to reconfigure your shares, users, and other system settings, but your data should be intact.

If you cannot remember your drive assignments, please post on the forum for further assistance (under General Support).

How do I go about getting an extension for my Unraid Trial?

Simple! Simply reboot your server and navigate to the Tools > Registration page. From there you can click to request an extension. Please remember that you are only allotted up to two extensions, each for two weeks. No further extensions can be issued thereafter.

I received the message "This GUID is already registered to another user." What do I do?

The flash device you are attempting to use does not have a unique ID. You will need to procure a different USB flash device for use with Unraid OS. As a reminder, Unraid OS does not support installation to SD card readers or anything other than a proper USB flash drive.

I wish to completely start configuring Unraid OS from scratch. How do I wipe my existing configuration / filesystems and do that?

  1. Ensure there is no data on the system that you require.
  2. Stop the array and shut down the server.
  3. Remove the USB flash device.
  4. Using a Windows or Mac computer, reformat the flash using the USB Flash Creator tool from our website.
  5. Reinstall the flash in the server and boot it up.
  6. Click on the "terminal" icon in the top right corner of the webGui.
  7. From the command line, type this: lsblk
  8. Note all the devices present excluding your USB flash device.
  9. Now for each device in the list (excluding the USB flash device), type the following command: wipefs /dev/sdX (replacing X with the letter of the device from the previous steps). This will remove the filesystem from the device so it can be reformatted by Unraid OS.
  10. Now continue reconfiguring Unraid OS per the normal procedure.

Whenever I shut down my Windows 10 VM with my AMD GPU assigned, if I try to start it again, it doesn't work. What do I do?

This is due to issues with many AMD GPUs not supporting function-level resets. NVIDIA GPUs are recommended as they do not have this problem. A workaround to this issue is to eject the GPU from the VM before shutting it down. You can do this from the bottom right corner in Windows where you would also find any USB devices. Just eject the GPU, then use another machine to shut down the VM from the Unraid webGui. Then when you start it again, it shouldn't have any problems.

How do I pass through my primary GPU to a VM when my CPU doesn't have an integrated graphics device?

This can be a challenge, but luckily our friendly community member SpaceInvaderOne has this covered in a video guide on our forums: https://forums.unraid.net/topic/51230-video-guidehow-to-pass-through-an-nvidia-gpu-as-primary-or-only-gpu-in-unraid/

What's the best way to add more storage to a system than the built-in controller supports?

Unraid can easily scale storage across multiple controllers in a system. The controllers must act as standard HBAs and not actual "RAID" controllers. Most RAID controllers offer an option to either flash their firmware or reconfigure the card into a mode to operate this way.

Does Unraid support various RAID types such as RAID1/5/6/10?

Unraid manages storage in two separate buckets: the array and the cache. The array itself uses dedicated parity device(s) similar to a MAID (https://searchstorage.techtarget.com/definition/MAID). The array cannot be configured into traditional RAID methods such as RAID 1/5/6/10.

The cache is created using btrfs. When more than one disk is present, the cache is called a "pool" and is by default configured to use btrfs RAID1, which is a slightly different take than a traditional RAID1. The cache can optionally be configured to use btrfs RAID 5/6/10, but RAID 5/6 on btrfs is still considered unstable, so it isn't recommended for production use.

I'm getting an error registering my flash device: '####-####-####-#############' is already registered to another user. What do I do?

The flash device you are trying to use with Unraid OS doesn't have a unique ID, and therefore is ineligible for registration. Please obtain a different USB flash device for use with Unraid OS. A few brands that work best include SanDisk, Lexar, or PNY.