6b26c54b49
* Bug fixes & more verbose * More error handling * Better bash fu * Fix GUACAMOLE-760 https://issues.apache.org/jira/browse/GUACAMOLE-760 ``` Cause: java.sql.SQLException: The server time zone value 'xyz' is unrecognized or represents more than one time zone. You must configure either the server or JDBC driver (via the serverTimezone configuration property)..... ``` * Address a few formatting issues * Make sure MySQL is up first & remove dead code * Hide some errors |
||
---|---|---|
.gitattributes | ||
.gitignore | ||
docker-install.sh | ||
guac-install-server.sh | ||
guac-install.sh | ||
guac-upgrade.sh | ||
README.md |
guac-install
Script for installing Guacamole 1.1.0 on Ubuntu 16.04 or newer (with MySQL, or remote MySQL). It should also work on pure Debian, Raspbian or Kali Linux. I have tested this with Debian 10.3.0 (Buster). If other versions don't work please open an issue. It is likely due to a required library having a different name.
Run script, enter MySQL Root Password and Guacamole User password. Guacamole User is used to connect to the Guacamole Database.
The script attempts to install tomcat9
by default (it will fall back on tomcat8
if the available version is 8.5.x or newer, otherwise it will fall back to tomcat7
). If you want to manually specify a tomcat version there's a commented out line you can modify. Have at it.
If you're looking to also have NGINX / Let's Encrypt / HTTPS click HERE
MFA/2FA
By default the script will not install MFA support (QR code for Google/Microsoft Authenticator, Duo Mobile, etc. or Duo Push), if you do want MFA support you can use the -t
or --totp
or for Duo -d
or --duo
flags on the command line. Or modify the script variables installTOTP=true
or installDuo=true
. Do not install both
How to Run:
Download file directly from here:
wget https://git.io/fxZq5
Make it executable:
chmod +x guac-install.sh
Run it as root:
Interactive (asks for passwords):
./guac-install.sh
Non-Interactive (values provided via cli):
./guac-install.sh --mysqlpwd password --guacpwd password --nomfa --installmysql
OR
./guac-install.sh -r password -gp password -o -i
Once installation is done you can access Guacamole by browsing to: http://<host_or_ip>:8080/guacamole/
The default credentials are guacadmin
as both username and password. Please change them or disable guacadmin after install!
guac-upgrade
Script for upgrading currently installed Guacamole instance (previously installed via this script/guide). This will also now update the TOTP or Duo extensions if used.
If looks for the tomcat folder in /etc/ (E.G. /etc/tomcat7
or /etc/tomcat8
) hopefully that works to identify the correct tomcat version/path 😄 I'm open to suggestions/pull requests for a cleaner method.
All Switches
Install MySQL:
-i or --installmysql
Do NOT install MySQL:
-n or --nomysql
MySQL Host:
-h or --mysqlhost
MySQL Port:
-p or --mysqlport
MySQL Root Password:
-r or --mysqlpwd
Guacamole Database:
-db or --guacdb
Guacamole User:
-gu or --guacuser
Guacamole User Password:
-gp or --guacpwd
No MFA (No TOTP + Duo):
-o or --nomfa
Install TOTP:
-t or --totp
Install Duo:
-d or --duo
NOTE: Only the switches for MySQL Host, MySQL Port and Guacamole Database are available in the upgrade script.
WARNING
- Upgrading from 0.9.14 -> 1.1.0 has not been tested, only 1.0.0 -> 1.1.0.
- Switches have changed and additional ones have been added!
How to Run:
Download file directly from here:
wget https://raw.githubusercontent.com/MysticRyuujin/guac-install/master/guac-upgrade.sh
Make it executable:
chmod +x guac-upgrade.sh
Run it as root:
Interactive (asks for passwords):
./guac-upgrade.sh
Non-Interactive (MySQL root password provided via cli):
./guac-upgrade.sh --mysqlpwd password