Editing Installation on other distributions


The [https://looking-glass.io/docs/stable/install Official Documentation] contains installation instructions for Debian-based distributions and should work fine on derivatives. The following are supplemental guides for other distributions, which do not work using the Debian instructions.

<!-- Debian example for reference. Do not include --!

apt-get install binutils-dev cmake fonts-freefont-ttf libfontconfig1-dev libegl-dev libspice-protocol-dev nettle-dev libx11-dev libxi-dev libxinerama-dev libxss-dev libwayland-dev wayland-protocols
-->

== Fedora 35+ ==

=== Installing Dependencies for Client Build ===
                              <!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
dnf install cmake gcc gcc-c++ libglvnd-devel fontconfig-devel spice-protocol make nettle-devel \
            pkgconf-pkg-config binutils-devel libXi-devel libXinerama-devel libXcursor-devel \
            libXpresent-devel libxkbcommon-x11-devel wayland-devel wayland-protocols-devel \
            libXScrnSaver-devel libXrandr-devel dejavu-sans-mono-fonts
</syntaxhighlight >

=== Installing Additional Dependencies for Kernel Module Build ===

<syntaxhighlight lang=bash>
dnf install dkms kernel-devel kernel-headers
</syntaxhighlight >

== OpenSuSE Leap 15.0+ ==

=== Installing Dependencies ===
                              <!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
zypper install binutils-devel make cmake fontconfig-devel libSDL2-devel libSDL2_ttf-devel spice-protocol-devel libX11-devel libnettle-devel wayland-protocols-devel \
               libconfig-devel libXi-devel libXss-devel libwayland-egl-devel nettle
</syntaxhighlight >

== Arch Linux / Manjaro ==

=== Installing Dependencies for Client Build ===
                              <!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
pacman -Syu cmake gcc libgl libegl fontconfig spice-protocol make nettle pkgconf binutils \
            libxi libxinerama libxss libxcursor libxpresent libxkbcommon wayland-protocols \
            ttf-dejavu
</syntaxhighlight>

=== Installing Additional Dependencies for Kernel Module Build ===

<syntaxhighlight lang=bash>
pacman -Syu dkms linux-headers
</syntaxhighlight >

== Void Linux ==

=== Installing Dependencies ===
                              <!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
xbps-install -Syu binutils-devel cmake freefont-ttf fontconfig-devel SDL2-devel SDL2_ttf-devel spice-protocol libX11-devel nettle-devel \
                  gcc make pkg-config
</syntaxhighlight>

== Gentoo ==

=== Installing Dependencies ===
First set up the necessary USE flags if needed:
<syntaxhighlight lang=bash>
echo "media-libs/libsdl2 gles2" >> /etc/portage/package.use/libsdl2
echo "media-libs/nettle gmp" >> /etc/portage/package.use/nettle
</syntaxhighlight>
Then fetch the packages:
                              <!-- Dependencies must match Debian's order, and extra dependencies must be on another line, with a consistent order -->
<syntaxhighlight lang=bash>
emerge sys-devel/binutils dev-util/cmake media-fonts/freefonts media-libs/libsdl2 media-libs/sdl2-ttf app-emulation/spice-protocol \
       media-libs/fontconfig dev-libs/nettle \
       media-libs/glu
</syntaxhighlight>
This list can also be placed into a setfile in /etc/portage/sets/ so that they can be updated with 
<syntaxhighlight lang=bash>
emerge @setfile
</syntaxhighlight>

== Proxmox ==

=== Prerequisites ===

* A working Proxmox install on a computer with 2 GPU's (Tested with 7.1-6)
* A Windows VM with GPU pass-through working (Tested with Win 10)
* A Linux VM with GPU pass-through working (Tested With Ubuntu 21.10)
* Proxmox Host Installed and running on the Windows VM

=== Windows VM setup ===

Using the Proxmox GUI, Set the Windows VM Display to "none"

Then in a shell to the Proxmox host edit the Windows VM Config:
<syntaxhighlight lang=bash>
nano /etc/pve/qemu-server/**YOUR-WINDOWS-VM-ID**.conf
</syntaxhighlight>
And add the following arguments to the args: line. If the args: line doesn't exist, create it at the top of the config.
<syntaxhighlight lang=bash>
-device ivshmem-plain,memdev=ivshmem,bus=pcie.0 -object memory-backend-file,id=ivshmem,share=on,mem-path=/dev/shm/looking-glass,size=32M -device virtio-mouse-pci -device virtio-keyboard-pci -spice 'addr=0.0.0.0,port=[spice port],disable-ticketing=on' -device virtio-serial-pci -chardev spicevmc,id=vdagent,name=vdagent -device virtserialport,chardev=vdagent,name=com.redhat.spice.0
</syntaxhighlight>
The -device virtio-mouse-pci -device virtio-keyboard-pci are not strictly necessary but should reduce input latency.

[spice port] should be replaced by a tcp port not in use.

Boot the Windows VM

=== Linux VM setup ===

In a shell to the Proxmox host edit the Linux VM Config:
<syntaxhighlight lang=bash>
nano /etc/pve/qemu-server/**YOUR-LINUX-VM-ID**.conf
</syntaxhighlight>
And add the arguments to the args: line. If the args: line doesn't exist, create it at the top of the config. 
<syntaxhighlight lang=bash>
-device ivshmem-plain,memdev=ivshmem,bus=pcie.0 -object memory-backend-file,id=ivshmem,share=on,mem-path=/dev/shm/looking-glass,size=32M
</syntaxhighlight>
Then boot the Linux VM, and download the latest Looking-glass source from https://looking-glass.io/downloads (Tested with version B5.0.1)

Follow the Official Looking-glass documentation on how to Build Looking-Glass Client - https://looking-glass.io/docs/B5.0.1/build/#building

Follow the Official Looking-glass documentation on how to install the kernel module - https://looking-glass.io/docs/B5.0.1/module/

=== Running Looking-Glass ===

# Make sure both VMs are running.
# On the Linux VM, open a terminal and cd to the looking glass client build folder
# Run Looking-Glass with:
<syntaxhighlight lang=bash>
 ./looking-glass-client -f /dev/kvmfr0 -c **Your_Proxmox_Host_IP** -p **spice port specified**
</syntaxhighlight>