You should have a reasonably new kernel (3.2+), with the
driver enabled and loaded (kernel module
hid-logitech-dj) or Linux 3.19+
hid-logitech-hidpp); also, the
udev package must be installed
and the daemon running. If you have a modern Linux distribution (2011+), you’re
most likely good to go.
The command-line application (
bin/solaar-cli) requires Python 2.7.3 or 3.2+
(either version should work), and the
The GUI application (
bin/solaar) also requires Gtk3, and its GObject
Introspection bindings. The Debian/Ubuntu package names are
gir1.2-gtk-3.0; if you’re using another
distribution the required packages are most likely named something similar.
If the desktop notifications bindings are also installed (
you will also get desktop notifications when devices come online/go offline.
For gnome-shell/Unity support, you also need to have
Normally USB devices are not accessible for r/w by regular users, so you will need to do a one-time udev rule installation to allow access to the Logitech Unifying Receiver.
You can run the
rules.d/install.sh script from Solaar to do this installation
automatically (make sure to run it as your regular desktop user, it will switch
to root when necessary), or you can do all the required steps by hand, as the
rules.d/42-logitech-unifying-receiver.rulesfrom Solaar to
udevdaemon will automatically pick up this file using inotify.
By default, the rule allows all members of the
plugdevgroup to have read/write access to the Unifying Receiver device. (standard Debian/Ubuntu group for pluggable devices). It may need changes, specific to your particular system’s configuration. If in doubt, replacing
GROUP="<your username>"should just work.
Physically remove the Unifying Receiver and re-insert it.
This is necessary because if the receiver is already plugged-in, it already has a
/dev/hidrawXdevice node, but with the old (
root:root) permissions. Plugging it again will re-create the device node with the right permissions.
Make sure your desktop users are part of the
plugdevgroup, by running
gpasswd -a <desktop username> plugdev. If these users were not assigned to the group before, they must re-login for the changes to take effect.