Editing Troubleshooting

There are many different issues that can arise when setting up Looking Glass. Below is a list of known issues with potential solutions:

=== When Launching Looking Glass the Desktop Doesn't Appear ===
*''' Using an AMD GPU? '''
** After the end of the Radeon HD Series AMD started incorporating a feature into their GPU's that effectively puts the card to sleep when no display is connected. For this reason one of two conditions need to be met.
### The GPU needs to remain plugged into a monitor (this is good for testing & troubleshooting).
### The GPU needs to have a plug like the ones used in GPU Crypto mining installed to trick the card into thinking that a display is connected.

=== The Clipboard is not Working ===
* '''Did you enable it?'''
** Before you can Copy/Paste content between the Guest and the Host you must [https://looking-glass.hostfission.com/wiki/FAQ#How_to_enable_clipboard_synchronization_via_SPICE Enable Clipboard Synchronization]
* '''Did you install the Spice Guest Tools?'''
** Before you can Copy/Paste content between the Guest and the Host you must install the [https://www.spice-space.org/download.html SPICE Guest Tools driver]. The download is labeled as "spice-guest-tools".
***<span style="color: red;">'''NOTE: Do make sure that you do NOT install the QEMU Guest Tools driver. These are not the same.'''</span>
* '''Are you using Wayland?'''
** Clipboard functionality is not compatible with Wayland. If you are using it you need to disable it for the clipboard to work.

=== Followed Installation Instructions but Looking Glass Still Doesn't Launch ===
At times depending on your distribution circumstances can cause Looking Glass to still not run. Below is a list of known issues that can prevent Looking Glass from running properly.
==== AppArmor ====
AppArmor is a security application that can prevent Looking Glass from running. How to add security exceptions may vary on your distribution:
===== Debian(Ubuntu) =====
Start by opening the file <code>/etc/apparmor.d/abstractions/libvirt-qemu</code>. Now locate and edit the following lines to represent  how they appear in the example:
<syntaxhighlight lang=text>
# for usb access
   /dev/bus/usb/** rw,
   /etc/udev/udev.conf r,
   /sys/bus/ r,
   /sys/class/ r,
   /run/udev/data/* rw,
   /dev/input/* rw,

# Looking Glass
   /dev/shm/looking-glass rw,
</syntaxhighlight>
Save, exit, and restart AppArmor:
<syntaxhighlight lang=text>
sudo systemctl restart apparmor
</syntaxhighlight>