/ nginx

Setting up Guacamole 0.9.4 on Debian Wheezy

Needed a way to access Remote Desktop and other remote servers from behind a firewall. Windows RD Gateway doesn't work behind a nginx server (or I wasn't able to figure it out), so needed an alternative. Found Guacamole!

  1. Install Debian Wheezy

  2. Install tomcat sudo apt-get install tomcat

  3. Install Java JDK if you're going to compile the guacamole-client

  4. Follow most of the instructions on the Guacamole Website. Abbreviated version below:
    a. sudo apt-get install libcairo2-dev libpng12-dev libossp-uuid-dev
    b. might also need sudo apt-get install make and sudo apt-get install maven (for building the client)
    c. Download the latest stable release wget https://github.com/glyptodon/guacamole-server/archive/0.9.4.tar.gz
    d. Choose your supported remote server types, and install the required packages:
    RDP: sudo apt-get install libfreerdp-dev
    OpenSSL: sudo apt-get install libssl-dev
    Audio: sudo apt-get install libvorbis-dev
    e. tar -xzf guacamole-server-0.9.4.tar.gz
    f. run in the new directory: ./configure --with-init-dir=/etc/init.d
    g. then make
    h. then make install

  5. Building/Downloading the client
    a. Grab the latest client wget https://github.com/glyptodon/guacamole-client/archive/0.9.4.tar.gz
    b. tar -xzf 0.9.4.tar.gz
    c. cp guacamole-0.9.4.war /var/lib/tomcat7/webapps/guacamole.war
    d. Setup the guacamole.properties file

     		mkdir /etc/guacamole
             mkdir /usr/share/tomcat7/.guacamole
             nano /etc/guacamole/guacamole.properties

e. You can find a copy of guacamole.properties here
g. Create a user/connection file nano /etc/guacamole/user-mapping.xml. Example found here
6. Deploy Guacamole

    ln -s /yourpath/guacamole/guacamole.war /var/lib/tomcat7/webapps
    ln -s /etc/guacamole/guacamole.properties /usr/share/tomcat7/.guacamole/
  1. Restart tomcat service tomcat7 restart
  2. Start guacamole service guacd restart
  3. You should now be able to access Guacamole at http://yourip
  4. Set up your nginx to reverse proxy to the Guacamole server
  5. Future considerations. Set up AJP module for nginx
Setting up Guacamole 0.9.4 on Debian Wheezy
Share this