User Tools

Site Tools


guacamole

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
guacamole [2018/12/06 20:00]
abeverley
guacamole [2018/12/06 20:04] (current)
abeverley
Line 9: Line 9:
 These brief instructions show how to set up Guacamole on a remote server, so that it can be used as a demo machine, controllable and viewable by anyone with a web browser. I use this to perform remote demonstrations of web-based software. The instructions assume that a Debian Jessie system is used, with Apache already installed. These brief instructions show how to set up Guacamole on a remote server, so that it can be used as a demo machine, controllable and viewable by anyone with a web browser. I use this to perform remote demonstrations of web-based software. The instructions assume that a Debian Jessie system is used, with Apache already installed.
  
-  ​* Install required packages:+* Install required packages:
  
-''​%%   apt-get install xfce4 chromium guacamole-tomcat x11vnc xrdp libguac-client-rdp0%%''​+''​apt-get install xfce4 chromium guacamole-tomcat x11vnc xrdp libguac-client-rdp0''​
  
-  ​* Configure Apache as a proxy to Tomcat (and Guacamole)+* Configure Apache as a proxy to Tomcat (and Guacamole)
  
-<​html>​<​VirtualHost _default_:​443>​</​html>​\\ +  ​<​VirtualHost _default_:​443>​ 
-''​%%    ProxyPass        %%''​[[http://​localhost:​8080/​guacamole/​|''​%%http://​localhost:​8080/​guacamole/​%%''​]]''​%% flushpackets=on%%''​\\ +    ​ProxyPass ​       http://​localhost:​8080/​guacamole/​ flushpackets=on 
-''​%%    ProxyPassReverse %%''​[[http://​localhost:​8080/​guacamole/​|''​%%http://​localhost:​8080/​guacamole/​%%''​]]\\ +    ​ProxyPassReverse ​/ http://​localhost:​8080/​guacamole/​ 
-''​%%    ProxyPassReverseCookiePath /​guacamole/​ /​%%''​\\ +    ​ProxyPassReverseCookiePath ​/guacamole/ / 
-''​%%    SSLEngine on%%''​\\ +    ​SSLEngine on 
-''​%%    SSLCertificateFile  /​etc/​ssl/​certs/​mycert.pem%%''​\\ +    ​SSLCertificateFile  ​/​etc/​ssl/​certs/​mycert.pem 
-''​%%    SSLCertificateKeyFile /​etc/​ssl/​private/​mykey.key%%''​\\ +    ​SSLCertificateKeyFile ​/​etc/​ssl/​private/​mykey.key 
-<​html>​</​VirtualHost></​html>+  </​VirtualHost>​
  
   * Add an RDP user to the Guacamole user config (/​etc/​guacamole/​user-mapping.xml)   * Add an RDP user to the Guacamole user config (/​etc/​guacamole/​user-mapping.xml)
  
-<​html>​<​authorize username="​myuser"​ password="​mypass">​</​html>​\\ +  ​<​authorize username="​myuser"​ password="​mypass">​ 
-''​%%    %%''<​html>​<​protocol>​</​html>''​%%rdp%%''<​html>​</​protocol>​</​html>​\\ +    <​protocol>​rdp</​protocol>​ 
-''​%%    %%''<​html>​<param name="​hostname">​</​html>''​%%localhost%%''<​html>​</​param>​</​html>​\\ +    <param name="​hostname">​localhost</​param>​ 
-''​%%    %%''<​html>​<param name="​port">​</​html>''​%%3389%%''<​html>​</​param>​</​html>​\\ +    <param name="​port">​3389</​param>​ 
-''​%%    %%''<​html>​<param name="​password">​</​html>''​%%rdp_pass%%''<​html>​</​param>​</​html>​\\ +    <param name="​password">​rdp_pass</​param>​ 
-<​html>​</​authorize></​html>+  </​authorize>​
  
 Edit a connection to /​etc/​xrdp/​xrdp.ini Edit a connection to /​etc/​xrdp/​xrdp.ini
  
-''​%%[xrdp0]%%''​\\ +  ​[xrdp0] 
-''​%%name=My connection%%''​\\ +  name=My connection 
-''​%%lib=libvnc.so%%''​\\ +  lib=libvnc.so 
-''​%%username=%%''​\\ +  username= 
-''​%%password=vnc_pass or "​ask"​%%''​\\ +  password=vnc_pass ​or "​ask"​ 
-''​%%ip=127.0.0.1%%''​\\ +  ip=127.0.0.1 
-''​%%port=5900%%''​+  port=5900
  
 ''​%%systemctl restart xrdp.service%%''​ ''​%%systemctl restart xrdp.service%%''​
Line 55: Line 55:
 If running Debian Stretch, then also instal xserver-xorg-legacy:​ If running Debian Stretch, then also instal xserver-xorg-legacy:​
  
-''​%%Fixes the following error:%%''​\\ +  ​Fixes the following error
-''​%%#​ parse_vt_settings:​ Cannot open /dev/tty0 (Permission denied)%%''​\\ +  # parse_vt_settings: ​Cannot open /dev/tty0 (Permission denied
-''​%%apt-get install xserver-xorg-legacy%%''​+  apt-get install xserver-xorg-legacy
  
 Change to the normal user and start the required X services: Change to the normal user and start the required X services:
  
-''​%%su andrew%%''​\\ +  su andrew 
-''​%%x11vnc -storepasswd As configured in /​etc/​xrdp/​xrdp.ini%%''​\\ +  ​x11vnc ​-storepasswd ​As configured in /​etc/​xrdp/​xrdp.ini 
-''​%%startx &%%''​\\ +  ​startx ​
-''​%%x11vnc -noncache -usepw -display :-rfbport 5900 -shared%%''​+  ​x11vnc ​-noncache ​-usepw -display ​:-rfbport 5900 -shared
  
 It should now be possible to browse to the site configured in Apache, login to Guacamole, and see a standard XFCE desktop. Chromium (or Iceweasal/​Firefox) can be launched from the applications menu. It should now be possible to browse to the site configured in Apache, login to Guacamole, and see a standard XFCE desktop. Chromium (or Iceweasal/​Firefox) can be launched from the applications menu.
guacamole.1544126426.txt.gz · Last modified: 2018/12/06 20:00 by abeverley