====== X2Go Packages for Raspbian GNU/Linux ======

To get started you'll need to configure your local system to access the official X2Go Raspbian repository. Please keep in mind that this installation manual will guide you through the installation on a Raspbian jessie, stretch or buster system. Only the armhf architecture is supported.


===== Adding This Repository To Your Package System =====

==== Bootstrapping the Repository GPG Keys ====

<note important>X2Go Packages for Debian and the repository metadata are signed with a GPG key to counter Man-in-the-Middle attacks. If you install X2Go components for the first time on a machine, you will have to bootstrap the repository and package signing key first in order for apt to validate the downloaded repository metadata and use it.</note>

Please switch to a user which has administrator privileges on your system in your preferred command line client:

<code bash>
su -
</code>
or
<code bash>
sudo -s
</code>


The following command will ensure that your system will be able to work with the repository archive key.
<code bash>
$ apt-key adv --recv-keys --keyserver keys.gnupg.net E1F958385BFE2B6E
</code>

==== Adding the Actual Repository ====

Please add the file ''x2go.list'' to the folder ''/etc/apt/sources.list.d/''.
This can be done by using your preferred editor.

<note>If you have not gotten a directory named ''/etc/apt/sources.list.d/'' add the lines to ''/etc/apt/sources.list''.</note>

<code bash>
$ editor /etc/apt/sources.list.d/x2go.list
</code>

Then add the X2Go repository (binaries and sources) as a couple of new lines (example for Raspbian **buster**):

<file - x2go.list>
# X2Go Repository (release builds)
deb http://packages.x2go.org/raspbian buster main
# X2Go Repository (sources of release builds)
deb-src http://packages.x2go.org/raspbian buster main

# X2Go Repository (Saimaa ESR builds)
#deb http://packages.x2go.org/raspbian buster saimaa
# X2Go Repository (sources of release builds)
#deb-src http://packages.x2go.org/raspbian buster saimaa

# X2Go Repository (nightly builds)
#deb http://packages.x2go.org/raspbian buster heuler
# X2Go Repository (sources of nightly builds)
#deb-src http://packages.x2go.org/raspbian buster heuler
</file>

**Edit this new data** and make sure to uncomment desired components and comment non-desired components. Only one group may be active at a given time.

<note warning>While we do offer pseudo-codenames like ''oldstable'', ''stable'', ''testing'' and ''unstable'' for convenience, you **should not use them**. Our pseudo-codename setup is not guaranteed to be in sync with Debian's releases, so using the ''stable'' codename might mean that you will actually get packages for what Debian calls ''oldstable'' after a new Debian distro release for a considerable amount of time.</note>

<note warning>Switching between components usually requires uninstalling all X2Go packages first! The only upgrade path that is considered somewhat safe is main (release packages) to heuler (nightly packages), but there are no guarantees regarding the stability or usefulness of nightly packages.</note>

==== Synchronize the Newly Added Repository's Metadata ====

Please perform an update of your APT package database:

<code bash>
$ apt-get update
</code>

<note important>If you were unable to bootstrap the repository GPG key previously, apt-get will fail to validate the signatures and discard the downloaded repository metadata.
\\ \\ 
**Not being able to verify signatures means that any content downloaded from the remote location could be injected/offered by a malicious third party and need not come from the X2Go Project. This includes repository metadata and any packages downloaded from unauthenticated repositories. Installing the x2go-keyring package from an unauthenticated repository bears the chance that this is not our package but a malicious third-party one which will not contain our public keys. This holds for all packages installed from this repository, now and later.**
\\ \\ 
You can bypass apt's internal checks **if you understand the implications** and are ready to take the risk by **once** using:
\\ \\ 
<code bash>
$ apt-get update --allow-insecure-repositories
</code>

Otherwise, please try to first fetch the key again as outlined in the bootstrapping instructions.
</note>

After the update you should be able to access the X2Go packages via the apt command family. As a first action you should install our ''x2go-keyring'' package and refresh the apt cache:

<code bash>
$ apt-get install x2go-keyring && apt-get update
</code>

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

Now you can search for X2Go related packages that are now available for your APT system:

<code bash>
$ apt-cache 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.


===== Mirroring This Repository =====

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

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