Ubuntu 14.04 with Guacamole 0.9.7

Guacamole is an RDP gateway. This tutorial assumes you have a freshly installed Ubuntu 14.04 server.

Install Dependencies

  • apt-get install libcairo2-dev libpng12-dev libossp-uuid-dev tomcat7 tomcat7-admin

Install Optional Dependencies

  • RDP - libfreerdp-dev
  • Pango (SSH & Telnet text rendering) - libfreerdp-dev
  • SSH support - libssh2-1-dev
  • Telnet support - libtelnet-dev
  • VNC support - libvncserver-dev
  • VNC audio support - libpulse-dev
  • OpenSSL support - libssl-dev
  • Audio support for Ogg Vorbis - libvorbis-dev

Obtain Guacamole Source

  • wget -O guacamole-server-0.9.7.tar.gz http://sourceforge.net/projects/guacamole/files/current/source/guacamole-server-0.9.7.tar.gz/download
  • tar -xzf guacamole-server-0.9.7.tar.gz
  • cd guacamole-server-0.9.7

Build and Install from Source

  • ./configure --with-init-dir=/etc/init.d
  • make
  • make install
  • ldconfig
  • update-rc.d guacd defaults

Guacamole Config Files

  • mkdir /etc/guacamole
  • nano /etc/guacamole/guacamole.properties /etc/guacamole/user-mapping.xml
            • guacamole.properties
                • guacd-hostname: localhost
                  • guacd-port: 4822
                  • lib-directory: /var/lib/tomcat7/webapps/guacamole/WEB-INF/classes
                  • auth-provider: net.sourceforge.guacamole.net.basic.BasicFileAuthenticationProvider
                  • basic-user-mapping: /etc/guacamole/user-mapping.xml
              • user-mapping.xml
                  • <user-mapping>
                    • <authorize username="admin" password="admin>
                    • <connection name="server1">
                    • <protocol>rdp</protocol>
                    • <param name="hostname">0.0.0.0</param>
                    • <param name="port">3389</param>
                    • </connection>
                    • </authorize>
                    • <user-mapping>
  • mkdir /usr/share/tomcat7/.guacamole
  • ln -s /etc/guacamole/guacamole.properties /usr/share/tomcat7/.guacamole/guacamole.properties

Guacamole Client

  • wget -O guacamole-0.9.7.war http://sourceforge.net/projects/guacamole/files/current/binary/guacamole-0.9.7.war/download
  • cp guacamole-0.9.7-war /var/lib/tomcat7/webapps/guacamole.war

(Re)start Services and Test

  • service guacd start
  • service tomcat7 restart
  • Navigate to http://[ip of guac server]:8080/guacamole and log in with credentials from user-mapping.xml