Updated Apache Guacamole managed by EGroupware (markdown)

Ralf Becker 2020-04-18 11:08:07 +02:00
parent 23d546a12d
commit d24503cb2a

@ -38,15 +38,15 @@ HTTP_HOST=example.org apt install egroupware-guacamole
### Troubleshooting ### Troubleshooting
* check the log of the guacamole container (almost all of the problem below are reported there!)
```
docker logs -f guacamole
```
* check MariaDB/MySQL is not bound on localhost (package tries to change that to docker0 address 172.17.0.1) * check MariaDB/MySQL is not bound on localhost (package tries to change that to docker0 address 172.17.0.1)
``` ```
netstat -ln | grep 3306 netstat -ln | grep 3306
tcp 0 0 172.17.0.1:3306 0.0.0.0:* LISTEN tcp 0 0 172.17.0.1:3306 0.0.0.0:* LISTEN
``` ```
* check the log of the guacamole container
```
docker logs -f guacamole
```
* enable OpenID Connect request log in EGroupware (Administration > Applications > OpenID Connect / OAuth > Request log) * enable OpenID Connect request log in EGroupware (Administration > Applications > OpenID Connect / OAuth > Request log)
* if Guacamole can not talk to EGroupware (because your firewall is blocking access from inside to the external IP / NAT traversal), you can set the docker0 IP for the external hostname by uncommenting the following in /etc/egroupware-guacamole/docker-compose.yaml (be careful as indention by space is important in YAML files!) * if Guacamole can not talk to EGroupware (because your firewall is blocking access from inside to the external IP / NAT traversal), you can set the docker0 IP for the external hostname by uncommenting the following in /etc/egroupware-guacamole/docker-compose.yaml (be careful as indention by space is important in YAML files!)
``` ```
@ -63,3 +63,4 @@ docker-compose rm -f guacamole
docker-compose up -d guacamole docker-compose up -d guacamole
``` ```
* Guacamole requires a websocket connection! If you use your firewall or something else to terminate https (eg. a Synology), you have to configure it to proxy websockets too! Use developer tools of your browser an check for failed websocket messages on the console or pending websockets in the network tab. * Guacamole requires a websocket connection! If you use your firewall or something else to terminate https (eg. a Synology), you have to configure it to proxy websockets too! Use developer tools of your browser an check for failed websocket messages on the console or pending websockets in the network tab.
* ask for help under [Guacamole category in our forum](https://github.com/EGroupware/guacamole/) or [buy a support budget from EGroupware GmbH](https://www.egroupware.org/en/egroupware-support/)