====== X2Go Packages for Fedora GNU/Linux ======

<note warning>Do not mix-and-match packages from the official Fedora repository with packages from the X2Go Fedora repository. Due to differing version number schemes, you will definitely run into problems. If you **really** need to switch between repositories, make sure to uninstall all X2Go packages first.</note>

Select one approach listed here, thus either the official (downstream) Fedora packages repository, or our X2Go Fedora repository and stick to it.

Unreleased versions and unofficial (related to the Fedora project) release packages are only available directly from the X2Go project, follow the instructions in the [[#adding_the_x2go_repository_to_your_package_system|second section]] to configure your package manager for this.

Note that if you are on POWER (ppc64le), you will only be able to obtain X2Go from the official (downstream) Fedora packages repository.

===== Using the Official Fedora Packages Repository =====

Most, if not all, X2Go packages are available in the official Fedora repositories.

<note>The X2Go Project can not provide complete support for these packages. While the current downstream Fedora maintainer is part of the [[doc:organigram|X2Go development team]], X2Go developers generally do not have access to the official Fedora repository. Problems are best handled downstream.</note>

There is no need to add anything to use these packages.

You can search for X2Go related packages that are now available for your system via ''yum'' or ''dnf'', whatever is most appropriate for your system:

<code bash>
$ yum search x2go
</code>

or

<code bash>
$ dnf search x2go
</code>

Congratulations, you are now able to access the X2Go packages. You may continue by installing ''x2goserver'', ''x2goclient'' or ''pyhoca-gui'' or any other of the available packages.

===== Adding the X2Go Repository to Your Package System =====

<note>For unsupported, archived Fedora versions, please refer to [[wiki:repositories:archives:fedora|Fedora Archives]].</note>

==== Base Installation ====

Download the .repo file and save it to the correct location:
<code bash>
wget -O /etc/yum.repos.d/x2go.repo \
 https://packages.x2go.org/fedora/x2go.repo
</code>

For reference, the file will also be inlined here, with the original information being available on [[https://packages.x2go.org/fedora/x2go.repo]]:

{{url>https://packages.x2go.org/fedora/x2go.repo 720px|Fedora X2Go repository definition file}}

==== Customization ====

Edit this file with your preferred editor.

<code bash>
$ editor /etc/yum.repos.d/x2go.repo
</code>

As a rule of thumb: ''source''-labeled repositories are never needed, unless you want to build packages from source. ''extras''-tagged repositories are always needed.

By default, the ''release''-labeled repository is enabled and the ''nightly''-tagged repository is disabled. If you want to use the unreleased, more up-to-date packages, disable the ''release''-labeled repository and enable the ''nightly''-tagged repository.

==== Post-Addition Test ====

Now you can search for X2Go related packages that are now available for your system via ''yum'' or ''dnf'', whatever is appropriate for your system:

<code bash>
$ yum search x2go
</code>

or

<code bash>
$ dnf search x2go
</code>

Congratulations, you are now able to access the X2Go packages. You may continue by installing ''x2goserver-xsession'', ''x2goclient'' or ''pyhoca-gui'' or any other of the available packages.

==== Mirroring This Repository ====

The packages in this repository can be mirrored via ''rsync'':

<code>
rsync -avP packages.x2go.org::fedora </dest/path/of/local/mirror/fedora>
</code>