heading =WARNING|

message = This is recommended only for advanced users, proceed with caution.}}

Guacamole is an HTML5 remote desktop gateway.

No browser plugins are needed, and no client software needs to be installed. The client requires nothing more than a web browser supporting HTML5 and AJAX.

<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;">

'''WARNING:''' All commands in this tutorial are executed as <code>root</code> (or precede with <code>sudo</code>).</div>

The following dependencies are included so as to make as many features in Guacamole available to the installer. Install them with the following:

For Fedora 23 or newer (Fedora 21, substitute <code>yum</code> for <code>dnf</code>):

:'''NOTE:''' You will need to install the Amahi [https://www.amahi.org/apps/web-apps Web Apps] plug-in to use this guidance. Ensure you '''enable''' [[Advanced Settings]].

Login to your Amahi Dashboard and choose "Set Up" in the upper right.

Now select the "Apps" tab.

Fill in the name (guacamole) and leave everything else as it is.

hda-create-db-and-user guacdb

Create a working directory and move there

mkdir -p /var/hda/web-apps/guacamole/sqlauth && cd /var/hda/web-apps/guacamole/sqlauth

systemctl restart mariadb.service

The schema for MySQL was downloaded in the previous process.

Just change directories to the files location

cat ./*.sql | mysql -uroot -phda guacdb

Guacamole uses "guacd", a Guacamole server and a Guacamole Client for users to connect to the "guacd" server. We first install Guacamole Server.

ldconfig

Create a new directory and move to it.

mkdir -p /var/lib/guacamole && cd /var/lib/guacamole/

ln -s /var/lib/guacamole/guacamole.war /var/lib/tomcat/webapps/

Create a directory for the configuration file.

mkdir -p /etc/guacamole/

ln -s /etc/guacamole/guacamole.properties /usr/share/tomcat/.guacamole/

Restart Tomcat.

​systemctl restart tomcat

chkconfig guacd on

Create Symbolic links between guacamole in Tomcat and Amahi's webapp directory

ln -s /var/lib/tomcat/webapps/guacamole/* /var/hda/web-apps/guacamole/html

systemctl restart httpd

You can access the web login screen for Guacamole from other computers in the network you can access Guacamole by '''<nowiki>http://****:8080/guacamole</nowiki>''' (Where the "****" is the IP address of your Amahi server).

The default user is "guacadmin", with the default password of "guacadmin". You can change your password by editing your own user in the administration screen.

If you want Guacamole's web interface to be accessible outside of your LAN you will have to forward a random, unused port (1111, for example) to port 8080 in your router.