Tutorial for Installing Guacamole on Windows 11

Guacamole is an open-source web application that allows you to access your remote servers and desktops from anywhere with just a web browser. This tutorial will guide you through the steps to install Guacamole on Windows 11.

Prerequisites

Before installing Guacamole, make sure you have the following installed:

  • Java Development Kit (JDK) 1.8 or later
  • Apache Tomcat 9.0 or later
  • MySQL Server 8.0 or later

Step 1: Download Guacamole

Download the latest version of Guacamole from the official website at https://guacamole.apache.org/releases/.

Step 2: Extract the Package

Extract the downloaded package into a directory of your choice.

Step 3: Configure MySQL Server

  1. Open MySQL Workbench and connect to your MySQL Server.
  2. Create a new schema named guacamole.
  3. Import the schema file located in the extracted Guacamole package under guacamole-auth-jdbc/modules/guacamole-auth-jdbc-mysql/schema/.
  4. Create a new user and grant it all privileges to the guacamole schema.

Step 4: Copy Files to Tomcat

  1. Copy guacamole.war and guacamole-auth-jdbc.jar from the extracted package to the webapps directory of your Apache Tomcat installation.
  2. Copy mysql-connector-java.jar from the extracted Guacamole package directory to the lib directory of your Apache Tomcat installation.

Step 5: Configure Tomcat

  1. Open the conf/server.xml file in your Apache Tomcat installation directory.
  2. Edit the Connector element and add the following attributes:
proxyName="your.domain.com"
proxyPort="80"
scheme="http"

Replace your.domain.com with your actual domain name.

  1. Edit the Guacamole.properties file located at WEB-INF/classes in the guacamole.war package.
  2. Set the following properties:
mysql-hostname: localhost
mysql-port: 3306
mysql-database: guacamole
mysql-username: your-username
mysql-password: your-password

Replace your-username and your-password with the credentials of the MySQL user you created in Step 3.

Step 6: Start Apache Tomcat

Start your Apache Tomcat server and check the logs for any errors.

Step 7: Access Guacamole

Open a web browser and navigate to http://your.domain.com:8080/guacamole/. You should now be able to access the Guacamole login page.

Conclusion

Congratulations! You have successfully installed Guacamole on Windows 11. You can now access your remote servers and desktops from any device with just a web browser.