Compilation-guide-for-CentOS-7.md

Go to the documentation of this file.

# Compilation guide for CentOS 7

These are the instructions for people who want to test the latest version of Remmina (`master` branch) on CentOS 7.

This guide was tested on CentOS 7 GNOME Desktop without any other package/group.

If you want to uninstall the program, follow the instructions in the step 0.

**0.** It is important that no other `remmina` or `freerdp` version is installed, therefore we need to remove it.
```bash
# To check if a program is installed, we can use `whereis [program(s)]`
whereis freerdp remmina

# When `freerdp` is installed from the CentOS repo, use this command to remove it
sudo yum -y remove freerdp*

# When `freerdp` is installed from source code, enter the `freerdp` source code folder and run the following command
cd ${HOME}/git/freerdp
sudo rm $(cat install_manifest.txt)

# When `remmina` is installed from the CentOS repo, use this command to remove it
sudo yum -y remove remmina*

# When `remmina` is installed from source code, enter the `build` folder in `remmina` source code folder and run the following command
cd ${HOME}/git/remmina/build
sudo make uninstall

# Finally, we need to delete the empty folders of `remmina` and `freerdp`
# This needs to be run for uninstallation of either programs
sudo rmdir $(find $(whereis freerdp remmina | grep -Po "^[^:]*: \K.*$") -type d | tac)
```

**1.** Add necessary repos. Note that on CentOS 7 GNOME Desktop only `epel` and `rpmfusion-free-updates` are not installed by default. I presume that `base`, `extras` and `updates` repos are installed on all version of CentOS 7.
```bash
# epel: required for `openjpeg2-devel`, `openssl-devel`
sudo yum -y install epel-release
# rpmfusion-free-updates: required for `ffmpeg-devel`
sudo yum -y install https://download1.rpmfusion.org/free/el/rpmfusion-free-release-$(rpm -E %centos).noarch.rpm
```

**3.** Update your system and `yum` cache. This might require a reboot.
```bash
sudo yum -y update
```

**4.** Install dependencies of `freerdp` and `remmina`.
```bash
sudo yum -y install alsa-lib-devel avahi-ui-devel avahi-ui-gtk3 cmake cmake3 cups-devel \
ffmpeg-devel gcc gcc-c++ git glib2-devel gnutls-devel gstreamer1-devel \
gstreamer1-plugins-base-devel gtk3-devel json-glib-devel libappindicator-devel \
libappindicator-gtk3 libappindicator-gtk3-devel libgcrypt-devel libgnome-keyring-devel \
libSM-devel libsodium libsodium-devel libsoup-devel libssh-devel libvncserver-devel libX11-devel \
libXcursor-devel libXdamage-devel libXext-devel libXi-devel libXinerama-devel libxkbfile-devel \
libXrandr-devel libXtst-devel libXv-devel openjpeg2-devel openssl-devel pulseaudio-libs-devel \
telepathy-glib-devel vte3-devel webkitgtk4-devel xmlto
```

**5.** Clone FreeRDP and Remmina repos. You may want to modify the `${HOME}/git/{freerdp,remmina}` paths and the folder names.
```bash
mkdir -p ${HOME}/git/{freerdp,remmina}
cd ${HOME}/git
git clone https://github.com/FreeRDP/FreeRDP.git freerdp
git clone https://gitlab.com/Remmina/Remmina.git remmina
```

**6.** Build FreeRDP.
```
cd freerdp
mkdir build
cd build
# In the following line, the `DWITH_PULSE=ON` need to be included
cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_SSE2=ON -DWITH_PULSE=ON -DWITH_CUPS=on -DWITH_WAYLAND=off -DCMAKE_INSTALL_PREFIX:PATH=/usr ..
make && sudo make install
```

**7.** Make your system dynamic loader aware of the new libraries you installed
```bash
sudo ldconfig
```

**8.** Build Remmina.
```bash
mkdir ../../remmina/build
cd ../../remmina/build
# cd ../../remmina
# git checkout v1.3.4
# mkdir build
# cd build
cmake3 -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX:PATH=/usr -DCMAKE_PREFIX_PATH=/usr --build=build ..
make && sudo make install
```

**9.** Now you should be able to run Remmina with the following command or using the GUI.
```bash
remmina &> /dev/null &
```

NOTES for execution:

* Current GNOME Shell versions does not include system tray, therefore vanilla GNOME will not show the Remmina system tray icon and menu. Press <kbd>Super</kbd>+<kbd>M</kbd> to see the Remmina icon on the message bar. If you want to fix this, you could install either [AppIndicator Support](https://extensions.gnome.org/extension/615/appindicator-support/) or [TopIcons Plus](https://extensions.gnome.org/extension/1031/topicons/).
* [This might be outdated] XFCE and other desktop environments without app indicator support, will not show you the system tray icon if you are executing Remmina from its compilation folder (e.g. `~/git/remmina`) because it contains a folder named `remmina`. See [Bug #1363277 on Launchpad](https://bugs.launchpad.net/libappindicator/+bug/1363277)