* Obtaining and Installing VirtualGL

	!!! VirtualGL must be installed on any machine that will act as a VirtualGL
	server or as a client for the [[overview.txt#VGL_Transport][VGL Transport]].
	It is not necessary to install VirtualGL on the client if using VNC or
	another type of X proxy.

** Installing VirtualGL on Linux

	!!! If you are installing VirtualGL onto a fresh server, and you also intend
	to install the nVidia proprietary drivers, install VirtualGL prior to the
	nVidia drivers.  Otherwise, installing VirtualGL may trigger an installation
	of Mesa, which can modify the libGL symlinks that the nVidia drivers created.

	1. Download the appropriate VirtualGL binary package(s) for your system from
		the [[https://github.com/VirtualGL/virtualgl/releases][Releases area]] of the
		[[https://github.com/VirtualGL/virtualgl][VirtualGL GitHub project page]].
		RPM and Debian packages are provided for Linux distributions that contain
		GLIBC 2.17 or later.
		{nl}
		!!! If you want to run both 32-bit and 64-bit OpenGL applications with
		VirtualGL on 64-bit x86 Linux systems, then you will need to install both
		{file: VirtualGL-{val: _VERSION}.x86_64.rpm} and
		{file: VirtualGL-{val: _VERSION}.i386.rpm}, or both
		{file: virtualgl_{val: _VERSION}_amd64.deb} and
		{file: virtualgl32_{val: _VERSION}_amd64.deb}.
		({file: virtualgl32_{val: _VERSION}_amd64.deb} is a supplementary package
		that contains only the 32-bit server components.)

	2. cd to the directory where you downloaded the binary package(s), and issue
		the following commands as root:

		RPM-based systems using YUM :: {:}
		#Verb <<---
		rpm -e VirtualGL --allmatches
		yum install VirtualGL*.rpm
		---

		RPM-based systems using DNF :: {:}
		#Verb <<---
		rpm -e VirtualGL --allmatches
		dnf install VirtualGL*.rpm
		---

		RPM-based systems using YaST2 :: {:}
		#Verb <<---
		rpm -e VirtualGL --allmatches
		yast2 --install VirtualGL*.rpm
		---

		Other RPM-based systems (dependencies will not be installed automatically) :: {:}
		#Verb <<---
		rpm -e VirtualGL --allmatches
		rpm -i VirtualGL*.rpm
		---

		Debian-based systems :: {:}
		#Verb <<---
		dpkg -i virtualgl*.deb
		apt install -f
		---

** Installing the VirtualGL Client on OS X/macOS

	#. Download the VirtualGL Mac disk image
		({file: VirtualGL-{val: _VERSION}.dmg}) from the
		[[https://github.com/VirtualGL/virtualgl/releases][Releases area]] of the
		[[https://github.com/VirtualGL/virtualgl][VirtualGL GitHub project page]].

	#. Open the disk image, then open {file: VirtualGL-{val: _VERSION}.pkg}
		inside the disk image.  Follow the instructions to install the Mac
		VirtualGL Client.

** Installing the VirtualGL Client on Windows (Cygwin)

Use Cygwin Setup to install the VirtualGL package.

** Installing VirtualGL from Source

If you are using a platform for which there is not a pre-built VirtualGL binary
package available, then download the VirtualGL source tarball
({file: VirtualGL-{val: _VERSION}.tar.gz}) from the
[[https://github.com/VirtualGL/virtualgl/releases][Releases area]] of the
[[https://github.com/VirtualGL/virtualgl][VirtualGL GitHub project page]],
uncompress it, {pcode: cd VirtualGL-{val: _VERSION}}, and read the contents of
{file: BUILDING.md} for further instructions on how to build and install
VirtualGL from source.

** Uninstalling VirtualGL

*** Linux
#OPT: noList! plain!

As root, issue one of the following commands:

	RPM-based systems :: {:}
	#Verb: <<---
	rpm -e VirtualGL
	---

		!!! You may need to add ''--all-matches'' to the RPM command line if you
		have installed both the 32-bit and 64-bit VirtualGL RPMs.

	Debian-based systems :: {:}
	#Verb: <<---
	dpkg -r virtualgl
	---

	If you have also installed the 32-bit supplementary package:
	#Verb: <<---
	dpkg -r virtualgl32
	---

*** OS X/macOS
#OPT: noList! plain!

Open the {file: Uninstall VirtualGL} application, located in the
{file: VirtualGL} Applications folder.  You can also open a terminal and
execute:

#Verb: <<---
sudo /opt/VirtualGL/bin/uninstall
---

*** Windows (Cygwin)
#OPT: noList! plain!

Use Cygwin Setup to uninstall the VirtualGL package.
