Skip to main content

Manual Installation on Debian 11

In this guide, I will show you how to install Apache Guacamole server natively on Debian 11.

Apache Guacamole have a nice, official install guide for installing Guacamole natively, located at https://guacamole.apache.org/doc/gug/installing-guacamole.html#building-guacamole-server .

Update and install wget, build-essential

A fresh Debian 11 system does not come with wget or build-essential by default. 

Update your Debian installation, then install the two packages.

sudo apt update && sudo apt upgrade -y
sudo apt install -y build-essential wget

Screenshot 2023-04-18 001715.png

Install Apache Guacamole Dependencies

You can learn more about each dependencies from the official documentation: https://guacamole.apache.org/doc/gug/installing-guacamole.html#building-guacamole-server 

sudo apt install -y libcairo2-dev libjpeg62-turbo-dev libpng-dev libtool-bin uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev freerdp2-dev libpango1.0-dev libssh2-1-dev libvncserver-dev libwebsockets-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev

Screenshot 2023-04-18 115201.png

Install Tomcat 9

Tomcat is needed to run the Guacamole client applications. 

sudo apt install -y tomcat9 tomcat9-admin

Screenshot 2023-04-18 115225.png

Restart and enable Tomcat9 service at boot.

sudo systemctl start tomcat9
sudo systemctl enable tomcat9

Screenshot 2023-04-18 115248.png

Download and Compile the Guacamole Server

Guacamole Server needs to be compile from the source before it can be use. 

Download the package from the Apache website, and then extract the contents.

wget https://downloads.apache.org/guacamole/1.5.1/source/guacamole-server-1.5.1.tar.gz
tar -xzf guacamole-server-1.5.1.tar.gz

Screenshot 2023-04-18 115321.png

Change into the guacamole-server folder, and then run the ./configure command to run the pre-check process. This process will check your system to see if the conditions for compiling the Guacamole Server is satisfied or not.

cd guacamole-server-1.5.1
./configure --with-systemd-dir=/etc/systemd/system/

Screenshot 2023-04-18 115426.png

You should see the following check-list when the command finishes. 

Screenshot 2023-04-18 115436.png

Compile the server.

make

Screenshot 2023-04-18 115454.png

This will take a while. Once finished, we can install the application.

sudo make install

Screenshot 2023-04-18 115613.png

sudo ldconfig
sudo systemctl daemon-reload
sudo systemctl enable guacd

Screenshot 2023-04-18 115640.png