diff --git a/Apache-Guacamole-managed-by-EGroupware.md b/Apache-Guacamole-managed-by-EGroupware.md new file mode 100644 index 0000000..3e4d09c --- /dev/null +++ b/Apache-Guacamole-managed-by-EGroupware.md @@ -0,0 +1,50 @@ +Guacamole makes RDP or VNC desktops available via html5 inside EGroupware. +EGroupware supplies account information, authentication via OpenID Connect +and allows to manage connections. + +### EGroupware Guacamole app does the following: + +* Installs all tables (or views) for Apache Guacamole +* Everything account-related is a view, not a table +* EGroupware UI to create connections (Admin >> Guacamole >> Connections) +* One has to use EGroupware to assign permissions to connections +* Guacamole UI can be used to set advanced connection options + +> The app requires accounts stored in SQL. A workaround for using LDAP or ActiveDirectory for account storage (not just authentication), is to regularly use setup to migrate users and groups to SQL. + +### Installation instructions via your package manager + +#### Installation requirements (please check before attempting an installation!) +* Installation must happen on same physical machine as EGroupware itself +* You already installed EGroupware itself **AND** secured the installation with https / a certificate under it's final domain-name eg. https://example.org/egroupware +* MariaDB/MySQL can be used by user root without entering a password, create a /root/my.cnf file with following content: +``` +[client] +password = my secret root password +``` +#### Installation (as user root replacing example.org with your actual domain) +``` +apt update +HTTP_HOST=example.org apt install egroupware-guacamole +``` +### List of resources / further reading: +* [Apache Guacamole website](https://guacamole.apache.org) +* [Using Guacamole section of Guacamole manual](https://guacamole.apache.org/doc/gug/using-guacamole.html) +* [Administration section of Guacamole manual](https://guacamole.apache.org/doc/gug/administration.html) (keep in mind to use EGroupware UI to assign connection permissions!) +* [Frequently Asked Questions from Guacamole](https://guacamole.apache.org/faq/) +* [Guacamole installation instructions for EGroupware](https://github.com/EGroupware/egroupware/wiki/Guacamole) +* [Guacamole category in our forum](https://help.egroupware.org/c/deutsch/guacamole) (German) +* [Guacamole EGroupware application repo on GitHub](https://github.com/EGroupware/guacamole/) + +### Troubleshooting + +* check MariaDB/MySQL is not bound on localhost (package tries to change that to docker0 address 172.17.0.1) +``` +netstat -ln | grep 3306 +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) \ No newline at end of file diff --git a/Guacamole.md b/Guacamole.md deleted file mode 100644 index 8cb7365..0000000 --- a/Guacamole.md +++ /dev/null @@ -1,22 +0,0 @@ -Guacamole makes RDP or VNC desktops available via html5 inside EGroupware. -EGroupware supplies account information, authentication via OpenID Connect -and allows to manage connections. - -#### EGroupware Guacamole app does the following: - -* Installs all tables (or views) for Apache Guacamole -* Everything account-related is a view, not a table -* EGroupware UI to create connections (Admin >> Guacamole >> Connections) -* One has to use EGroupware to assign permissions to connections -* Guacamole UI can be used to set advanced connection options - -> The app requires accounts stored in SQL. A workaround for using LDAP or ActiveDirectory for account storage (not just authentication), is to regulary use setup to migrate users and groups to SQL. - -#### List of ressources / further reading: -* [Apache Guacamole website](https://guacamole.apache.org) -* [Using Guacamole section of Guacamole manual](https://guacamole.apache.org/doc/gug/using-guacamole.html) -* [Administration section of Guacamole manual](https://guacamole.apache.org/doc/gug/administration.html) (keep in mind to use EGroupware UI to assign connection permissions!) -* [Frequently Asked Questions from Guacamole](https://guacamole.apache.org/faq/) -* [Guacamole installation instructions for EGroupware](https://github.com/EGroupware/egroupware/wiki/Guacamole) -* [Guacamole categegory in our Forum](https://help.egroupware.org/c/deutsch/guacamole) (German) -* [Guacamole EGroupware application repo on GitHub](https://github.com/EGroupware/guacamole/)