Unraid 6/Frequently Asked Questions

From unRAID
Revision as of 19:23, 15 February 2019 by Jonp (talk | contribs)
Jump to: navigation, search


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!

Does Unraid support hardware-based RAID controllers?

While some users have been able to use RAID controllers to present devices to Unraid OS for use, they definitely complicate things when it comes to features and maintenance. Disk temperatures and even some SMART values may not come through correctly when presented through a hardware RAID controller. Therefore we only officially support the use of non-RAID controllers for storage devices. Most RAID storage controllers offer a way to flash the firmware to convert the card into a basic HBA for devices (eliminating the RAID entirely), but you'll have to search for your specific controller to see if that is an option.

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

My system is crashing but my logs don't contain the event. What do I do to obtain support?

Sometimes a hard system crash can prevent you from obtaining vital information in the logs that would help better diagnose the issue. In the event you can't obtain the logs with a remote connection, you'll have to resort to a local one. Attach at least a monitor and keyboard to the server and boot it up into non-GUI mode. Once presented with the login prompt, login as the user 'root' and whatever password you set when you set up the server (if no password was set, leave it blank and press enter again). From the command line now, type the following command:

tail /var/log/syslog -f

This will begin printing the system log to the monitor directly. Now go about using the server as you normally would. When the crash occurs, take a picture of what's visible on the monitor and post it in the support forums. This will hopefully give us some further insight on the issue.

Is there any way to disable the br0 bridge?

Absolutely! Simply navigate to the Tools > Network Settings page to disable network bridging. Note that this will result in differences in behavior for virtual machines (including losing the ability to communicate with the host from a guest).

I've forgotten my root password to my system, how do I restore access?

Shutdown server and then plug usb boot flash device into a PC and delete these files:

config/shadow config/smbpasswd

Then plug flash back into server and start up again. This will reset all user passwords including ‘root’ user to null (blank).