Jump to content
We're Hiring! Full Stack Developer ×

How to Connect a Bluetooth Keyboard/Mouse to unRaid Server


Recommended Posts

I figured others might be interested in how to get a Bluetooth keyboard and mouse connected to their unRAID server so i wrote this short guide as my introductory post to the unRAID forums.


I realize there’s probably limited use for this, but in my case I have a multi device keyboard and mouse

and I can switch between them easily which is why I am using this on unRAID, it’s convenient for me.


System Requirements

You need to be running at least 6.7 as this includes the Bluetooth kernel drivers, you also need to install NerdPack and select the bluez package.


Getting it all Working

Once you’ve satisfied the system requirements, open a terminal on unRAID and execute:


/etc/rc.d/rc.bluetooth start


You should see Agent Registered and be at the Bluetooth prompt:


Put your device in pairing mode and execute:


scan on


You should see the device appear in the list as it scans, note the <address> then execute:


pair <address>


Note: After the pair you might get promoted to do something like enter a passcode in the case of a keyboard, enter the displayed number and press return. Repeat the pairing process for any other devices.


Once pairing is confirmed on screen, execute:


trust <address>
connect <address>


Type “exit” to quit.


Now we need to make this configuration persistent across boots, so execute:


cd /var/lib
tar -czvf /boot/config/bluetooth.tgz bluetooth


Note: This saves the paired devices to an archive, you will need to repeat this step if you pair other devices in the future.


Edit the go.cfg config file so it restores the Bluetooth configuration and start the Bluetooth daemon from the go file on boot.


cd /boot/config
nano go


Before the line that starts emhttp add the following lines:


tar xvzf /boot/config/bluetooth.tgz -C /var/lib

/etc/rc.d/rc.bluetooth start

hciconfig hci0 up


Hit ctrl-x and then press y to save the modified go file.

That’s it, upon reboot the Bluetooth configuration will be restored before the service is started.

Edited by nerdzero
  • Like 1
Link to comment
  • 3 months later...

Thanks for providing this!


I had some problems connecting after pair + trust.  I was getting the error "org.bluez.Error.Failed".  I followed some other instructions on StackOverflow to do


untrust <addr>
remove <addr>

I then ran


connect <addr>
trust <addr>


The pairing took place automatically after connecting.

Link to comment
  • 2 years later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Reply to this topic...

×   Pasted as rich text.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

  • Create New...