Install Guacamole 0.9.9 on LMDE 2 MATE

Guacamole is a clientless Remote Desktop gateway. With this tool we can connect to a remote desktop using any modern webbrowser. Here is how I install the latest version (0.9.9) on an LMDE 2 MATE System.

1. Install dependencies:

$ sudo apt-get install libcairo2-dev libjpeg62-turbo-dev libpng12-dev libossp-uuid-dev libfreerdp-dev libpango1.0-dev libssh2-1-dev libtelnet-dev libvncserver-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev

2. Download source code:

$ wget

3. Extract file and change directory:

$ tar -xzf guacamole-server-0.9.9.tar.gz
$ cd guacamole-server-0.9.9/

4. Configure:

$ ./configure --with-init-dir=/etc/init.d
checking for a BSD-compatible install... /usr/bin/install -c
checking whether build environment is sane... yes
checking for a thread-safe mkdir -p... /bin/mkdir -p
checking for gawk... gawk

guacamole-server version 0.9.9

 Library status:

 freerdp ............. yes
 pango ............... yes
 libssh2 ............. yes
 libssl .............. yes
 libtelnet ........... yes
 libVNCServer ........ yes
 libvorbis ........... yes
 libpulse ............ yes
 libwebp ............. yes

 Protocol support:

 RDP ....... yes
 SSH ....... yes
 Telnet .... yes
 VNC ....... yes

 Init scripts: /etc/init.d

Type "make" to compile guacamole-server.

5. Make:

$ make
make all-recursive
make[1]: Entering directory '/home/user/guacamole/guacamole-server-0.9.9'
Making all in src/libguac
make[2]: Entering directory '/home/user/guacamole/guacamole-server-0.9.9/src/libguac'
 CC libguac_la-audio.lo

make[2]: Leaving directory '/home/user/guacamole/guacamole-server-0.9.9/src/protocols/vnc'
make[2]: Entering directory '/home/user/guacamole/guacamole-server-0.9.9'
make[2]: Leaving directory '/home/user/guacamole/guacamole-server-0.9.9'
make[1]: Leaving directory '/home/user/guacamole/guacamole-server-0.9.9'

6. Create needed directories:

$ sudo mkdir -p /usr/local/share/man
$ sudo mkdir /etc/guacamole

7. Install guacamole-server using checkinstall:

$ sudo apt-get install checkinstall
$ sudo checkinstall

checkinstall 1.6.2, Copyright 2009 Felipe Eduardo Sanchez Diaz Duran
  Diese Software wurde unter der GNU GPL veröffentlicht

The package documentation directory ./doc-pak does not exist. 
Should I create a default set of package docs? [y]: 

Bereite Paket-Dokumentation vor...OK

Bitte geben Sie eine Beschreibung für das Paket ein.
Beenden Sie Ihre Beschreibung mit einer leeren Zeile oder EOF.

**** Debian package creation selected ***

Das Paket wird entsprechend dieser Vorgaben erstellt:

0 - Maintainer: [ root@lpmbox ]
1 - Summary: [ Package created with checkinstall 1.6.2 ]
2 - Name: [ guacamole-server ]
3 - Version: [ 0.9.9 ]
4 - Release: [ 1 ]
5 - License: [ GPL ]
6 - Group: [ checkinstall ]
7 - Architecture: [ amd64 ]
8 - Source location: [ guacamole-server-0.9.9 ]
9 - Alternate source location: [ ]
10 - Requires: [ ]
11 - Provides: [ guacamole-server ]
12 - Conflicts: [ ]
13 - Replaces: [ ]

Geben Sie die betreffende Nummer ein, um die Vorgaben zu ändern: 

Installing with make install...

====================== Installation erfolgreich ==========================

Copying documentation directory...

Kopiere Dateien in das temporäre Verzeichnis...OK

Stripping ELF binaries and libraries...OK

Komprimiere man-Seiten...OK

Erzeuge Datei-Liste...OK

Erstelle Debian-Paket...OK

Installiere Debian-Paket...OK

Lösche temporäre Dateien...OK

Schreibe Sicherungs-Paket...OK

Lösche temporäres Verzeichnis...OK


 Done. The new package has been installed and saved to


 You can remove it from your system anytime using: 

 dpkg -r guacamole-server


8. Make guacd to start automatically at system start:

$ sudo update-rc.d guacd defaults

9. Install Tomcat8:

$ sudo apt-get install tomcat8

10. Download web application package and put it in tomcat8 webapps directory with another name:

$ cd ..
$ wget
$ sudo cp guacamole-0.9.9.war /var/lib/tomcat8/webapps/guacamole.war

11. Configure guacamole. Edit “/etc/guacamole/user-mapping.xml”. Here is my “user-mapping.xml”:

 <authorize username="my_username"
  <connection name="my_connection_name">
   <param name="hostname">localhost</param>
   <param name="port">5900</param>

12. To get md5 hash from your password just type following line in terminal:

$ echo -n <your_password> | md5sum

13. Install “lightdm” and set it as default display manager:

$ sudo apt-get install lightdm lightdm-gtk-greeter

14. Configure “/etc/lightdm/lightdm.conf”. Here is my “lightdm.conf”:


15. Download no-authentication package, extract and install it:

$ wget
$ tar -xzf guacamole-auth-noauth-0.9.9.tar.gz
$ sudo mkdir /etc/guacamole/extensions
$ sudo cp guacamole-auth-noauth-0.9.9/guacamole-auth-noauth-0.9.9.jar /etc/guacamole/extensions/.

16. Configure no-authentication package. Here is my “/etc/guacamole/noauth-config.xml”:

 <config name="myconfig" protocol="vnc">
  <param name="hostname" value="localhost" />
  <param name="port" value="5900" />

17. Save following text as “/etc/guacamole/”:

# Guacamole - Clientless Remote Desktop
# Copyright (C) 2010 Michael Jumper
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU Affero General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# GNU Affero General Public License for more details.
# You should have received a copy of the GNU Affero General Public License
# along with this program. If not, see <>.

# Hostname and port of guacamole proxy
guacd-hostname: localhost
guacd-port: 4822

# Auth provider class (authenticates user/pass combination, needed if using the provided login screen)
basic-user-mapping: /etc/guacamole/user-mapping.xml

18. Add no authentication configuration to “/etc/guacamole/” by executing following command:

$ sudo bash -c 'printf "\n%s\n%s\n" "# NoAuth properties" "noauth-config: /etc/guacamole/noauth-config.xml" >> /etc/guacamole/'

19. Create symbolic link to tomcat8 directory:

$ sudo ln -s /etc/guacamole /usr/share/tomcat8/.guacamole

20. Install VNC Server and xinetd:

$ sudo apt-get install vnc4server xinetd

21. Configure xinetd to start vnc4server. Here is my “/etc/xinetd.d/vnc”:

service vnc
 disable = no
 socket_type = stream
 protocol = tcp
 wait = no
 user = nobody
 server = /usr/bin/Xvnc4
 server_args = -inetd -once -query localhost -geometry 1920x1080 -depth 24 -securitytypes=none
 type = UNLISTED
 port = 5900

22. Restart the system and connect to this system from another computer using a webbrowser by typing in “<ip-address>:8080/guacamole”.


23. That’s it. Happy remote desktopping!