Difference between revisions of "Guacamole"

From Amahi Wiki
Jump to: navigation, search
(Created page with "Coming soon...")
 
Line 1: Line 1:
Coming soon...
+
== What is Guacamole? ==
 +
Guacamole is an HTML5 remote desktop gateway. 
 +
 
 +
Guacamole provides access to desktop environments using remote desktop protocols like VNC and RDP. A centralized server acts as a tunnel and proxy, allowing access to multiple desktops through a web browser.
 +
 
 +
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.
 +
 
 +
== Installing Guacamole on Amahi ==
 +
=== Dependencies ===
 +
*tomcat6
 +
*libvncserver
 +
*freerdp (This is official on the Guacamole site. Fedora 14 will not support Freerdp 1.0 or higher, thus RDP protocol in Guacamole is not available.  Leave freerdp out of the code below if you are running Fedora 14.)
 +
*libvorbis
 +
 
 +
In terminal, as super-user, install dependencies with the following:
 +
 
 +
{{Code|
 +
Code = $ su
 +
Password:
 +
# yum install tomcat6 libvncserver freerdp libvorbis
 +
}}
 +
 
 +
=== Preparing Amahi ===
 +
Login to your Amahi Dashboard and choose "Set Up" in the upper right.
 +
Now select the "Apps" tab.
 +
Click on "Webapps" and on the page that comes up choose the "New Web App" button at the bottom.
 +
Fill in the name (guacamole) and leave everything else as it is.
 +
 
 +
=== Downloading the Binary Packages ===
 +
Go to http://guac-dev.org/ and choose from the table the binary packages for your system.  For '''Fedora 14''', I chose the '''Fedora 15''' packages and they worked flawlessly.
 +
 
 +
=== Installing Guacamole ===
 +
In terminal, change directories to where the packages downloaded and execute the following as super-user:
 +
{{Code|
 +
Code = # tar -xzf guacamole-0.8.0-fedora-15-i386.tar.gz
 +
# cd guacamole-0.8.0-fedora-15-i386/
 +
# rpm -i *.rpm
 +
}}
 +
*Be aware that you may have to adjust the above code to match the file name you downloaded.
 +
 
 +
 
 +
== Configuring Guacamole and Amahi ==
 +
coming soon!

Revision as of 03:28, 19 May 2013

What is Guacamole?

Guacamole is an HTML5 remote desktop gateway.

Guacamole provides access to desktop environments using remote desktop protocols like VNC and RDP. A centralized server acts as a tunnel and proxy, allowing access to multiple desktops through a web browser.

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.

Installing Guacamole on Amahi

Dependencies

  • tomcat6
  • libvncserver
  • freerdp (This is official on the Guacamole site. Fedora 14 will not support Freerdp 1.0 or higher, thus RDP protocol in Guacamole is not available. Leave freerdp out of the code below if you are running Fedora 14.)
  • libvorbis

In terminal, as super-user, install dependencies with the following:

bash code
​$ su Password: # yum install tomcat6 libvncserver freerdp libvorbis​


Preparing Amahi

Login to your Amahi Dashboard and choose "Set Up" in the upper right. Now select the "Apps" tab. Click on "Webapps" and on the page that comes up choose the "New Web App" button at the bottom. Fill in the name (guacamole) and leave everything else as it is.

Downloading the Binary Packages

Go to http://guac-dev.org/ and choose from the table the binary packages for your system. For Fedora 14, I chose the Fedora 15 packages and they worked flawlessly.

Installing Guacamole

In terminal, change directories to where the packages downloaded and execute the following as super-user:

bash code
​# tar -xzf guacamole-0.8.0-fedora-15-i386.tar.gz # cd guacamole-0.8.0-fedora-15-i386/ # rpm -i *.rpm​
  • Be aware that you may have to adjust the above code to match the file name you downloaded.


Configuring Guacamole and Amahi

coming soon!