Difference between revisions of "Apache Guacamole"

75 bytes added ,  02:36, 21 August 2022
Tags: Mobile web edit Mobile edit
 
(4 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Apache Guacamole is a self hosted web application for Remote Desktop services. Guacamole allows remote desktop services to be accessed over HTTP.
Apache Guacamole is a [[Self hosted applications|Self hosted application]] for Remote Desktop services. Guacamole allows remote desktop services to be accessed over HTTP.


The main page for Apache Guacamole can be accessed here:
The main page for Apache Guacamole can be accessed here:


https://guacamole.apache.org/
https://guacamole.apache.org/
== Guacamole Installation ==
==Guacamole Installation ==
This guide is best suited for a Guacamole installation on Ubuntu Server 20.04 LTS
This guide is best suited for a Guacamole installation on [[Ubuntu | Ubuntu Server 20.04 LTS]]


'''Run as Root'''
'''Run as Root'''
Line 77: Line 77:
'''Set Up MySQL Connector'''
'''Set Up MySQL Connector'''


<code>wget </nowiki>https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-auth-jdbc-1.4.0.tar.gz</code>
<code>wget &lt;/nowiki&gt;https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-auth-jdbc-1.4.0.tar.gz</code>


<code>tar -xf guacamole-auth-jdbc-1.4.0.tar.gz</code>
<code>tar -xf guacamole-auth-jdbc-1.4.0.tar.gz</code>
Line 140: Line 140:
Add the following:
Add the following:


<pre>
<Valve className="org.apache.catalina.valves.RemoteIpValve"
<Valve className="org.apache.catalina.valves.RemoteIpValve"
             internalProxies="127.0.0.1"
             internalProxies="127.0.0.1"
Line 145: Line 146:
             remoteIpProxiesHeader="x-forwarded-by"
             remoteIpProxiesHeader="x-forwarded-by"
             protocolHeader="x-forwarded-proto" />
             protocolHeader="x-forwarded-proto" />
</pre>
'''Restart tomcat9'''
<code>sudo systemctl restart tomcat9</code>
<code>sudo systemctl restart tomcat9</code>


Apache Guacamole should now be installed and reachable at <code>http://localhost:8080/guacamole</code>
Apache Guacamole should now be installed and reachable at <code>http://localhost:8080/guacamole</code>
Line 151: Line 157:
The default sign in credentials are username:<code>guacadmin</code> password:<code>guacadmin</code>
The default sign in credentials are username:<code>guacadmin</code> password:<code>guacadmin</code>


== Add TOTP Authentication ==
==Add TOTP Authentication ==
Download the TOTP extension for Apache Guacamole and install it to the extensions folder:
Download the TOTP extension for Apache Guacamole and install it to the extensions folder:


Line 161: Line 167:


<code>systemctl restart tomcat9</code>
<code>systemctl restart tomcat9</code>
== Fix RDP Connection Issues ==
==Fix RDP Connection Issues ==
If you have connection issues, check the logs by running:
If you have connection issues, fix by adding a guacd user:


<code>useradd -M -d /var/lib/guacd/ -r -s /sbin/nologin -c "Guacd User" guacd</code>
<code>useradd -M -d /var/lib/guacd/ -r -s /sbin/nologin -c "Guacd User" guacd</code>
Line 175: Line 181:


<code>systemctl restart guacd</code>
<code>systemctl restart guacd</code>
== See also ==
 
==See also ==
* [[Reverse Proxy]]
* [[Reverse Proxy]]
* [[Apache Web Server]]
* [[Apache Web Server]]
== References ==
==References ==
* https://adamtheautomator.com/apache-guacamole/
*https://adamtheautomator.com/apache-guacamole/
* https://kifarunix.com/install-guacamole-on-debian-11/#fix-rdp-security-negotiation-failed
*https://kifarunix.com/install-guacamole-on-debian-11/#fix-rdp-security-negotiation-failed
*https://kifarunix.com/configure-totp-two-factor-authentication-on-apache-guacamole/
*https://kifarunix.com/configure-totp-two-factor-authentication-on-apache-guacamole/
== Bibliography ==
==Bibliography ==
== External links ==
==External links ==
{{DEFAULTSORT:}}
{{DEFAULTSORT:}}
Anonymous user