---
title: "How to Install the Apache Guacamole Remote Desktop Gateway"
description: "Learn a new way to connect to remote servers or computers with Apache Guacamole as a remote desktop gateway in this step-by-step tutorial!"
canonical: "https://adamtheautomator.com/apache-guacamole/"
---

# How to Install the Apache Guacamole Remote Desktop Gateway

> Learn a new way to connect to remote servers or computers with Apache Guacamole as a remote desktop gateway in this step-by-step tutorial!

Source: https://adamtheautomator.com/apache-guacamole/

---

ATA Learning

Tap to hide

[

ATA Learning

](/)

*   [Home](/)
*   [Tutorials](/tutorials/)
*   [Instructors](/author/)
*   [Advertising](/advertising/)
*   [Recommended Resources](/resources/)
*   [About Adam](/about-adam/)

Search for:  

*   [](https://twitter.com/adbertram)
*   [](https://github.com/Adam-the-Automator)
*   [](https://www.linkedin.com/company/adam-the-automator-llc)
*   [](/feed/)

![How to Install the Apache Guacamole Remote Desktop Gateway](https://adamtheautomator.com/wp-content/uploads/2022/03/How-to-Install-the-Apache-Guacamole-Remote-Desktop-Gateway.jpg)

# How to Install the Apache Guacamole Remote Desktop Gateway

[![](https://secure.gravatar.com/avatar/572a248f516b6d0cd566cb44fdbd9336f30ef95aa0f6d78f118c1f47b1b6d6b7?s=192&d=mm&r=g)Arvid Larson](https://adamtheautomator.com/author/arvid-larson/)30 March 202211 min. read

Categories: [IT Ops](/category/it-ops/)

Tags:[windows server](/tag/windows-server/)

Table of Contents

*   [Prerequisites](#prerequisites)
*   [Installing Apache Guacamole’s Packages Dependencies](#installing-apache-guacamoles-packages-dependencies)
*   [Compiling and Installing Guacamole Server](#compiling-and-installing-guacamole-server)
*   [Creating Guacamole Configuration and Directory](#creating-guacamole-configuration-and-directory)
*   [Setting Up MariaDB Database](#setting-up-mariadb-database)
*   [Installing Database Authentication Extension and MySQL/J Library](#installing-database-authentication-extension-and-mysqlj-library)
*   [Configuring Apache Guacamole with MariaDB Database](#configuring-apache-guacamole-with-mariadb-database)
*   [Installing the Guacamole Client Web Application](#installing-the-guacamole-client-web-application)
*   [Setting Up Apache as a Reverse Proxy for Guacamole Client](#setting-up-apache-as-a-reverse-proxy-for-guacamole-client)
*   [Verifying Apache Guacamole](#verifying-apache-guacamole)
*   [Conclusion](#conclusion)

Administrators often use multiple types of applications for connecting to servers/computers. But have you wondered if there’s an easier way to do so? Why not use the [Apache Guacamole](https://guacamole.apache.org/) as a remote desktop gateway?

Apache Guacamole supports multiple connection protocols and only by using a web browser without additional tools or extensions. And in this tutorial, you’ll learn how to install Apache Guacamole as a remote desktop gateway.

Read on and connect to your servers/computers non-excessively!

## Prerequisites

This tutorial will be a hands-on demonstration. To follow along, ensure you have the following requirements:

*   A Linux server – This tutorial uses the latest Ubuntu 20.04 server.

Related:[How to Install Ubuntu 20.04 \[Step-by-Step\]](https://adamtheautomator.com/install-ubuntu/)

*   A root or administrator user.
    
*   A MariaDB database server installed on your server.
    

Related:[A MariaDB database server installed on your server. Related: Deploy a Production Docker MariaDB Installation](https://adamtheautomator.com/docker-mariadb/)

*   A domain name pointing to the server IP address – This tutorial uses the _example.io_ domain.

## Installing Apache Guacamole’s Packages Dependencies

Apache Guacamole is a clientless remote desktop gateway that allows you to connect to computers/servers from anywhere and any time by only using a web browser.

Apache Guacamole is free and open-source and supports multiple standard remote access protocols (such as SSH, VNC, and RDP) and have two main parts:

*   Guacamole Server – must be installed manually from the source code
*   Guacamole Client – the Java serverlet web application, running under the Apache Tomcat. This client is the front-end of the Apache Guacamole.

Before installing the Guacamole server and client, you must first install packages dependencies on your Linux server.

1\. Open your terminal and connect to your server.

2\. Next, run the [`apt install`](https://linuxize.com/post/how-to-use-apt-command/#installing-packages-apt-install) command below to install packages dependencies for building the Guacamole server.

```bash
sudo apt install build-essential libcairo2-dev libjpeg-turbo8-dev libpng-dev libtool-bin uuid-dev libossp-uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev freerdp2-dev libpango1.0-dev libssh2-1-dev libtelnet-dev libvncserver-dev libwebsockets-dev libpulse-dev libssl-dev libvorbis-dev libwebp-dev -y
```

![Installing Packages Dependencies](https://adamtheautomator.com/wp-content/uploads/2022/03/image-474.png)

Installing Packages Dependencies

3\. Next, run the below command to `install` the Apache Tomcat 9 package (`tomcat9`), which you’ll later use to run the Guacamole client application.

```bash
sudo apt install tomcat9 -y
```

![Installing Apache Tomcat 9](https://adamtheautomator.com/wp-content/uploads/2022/03/image-475.png)

Installing Apache Tomcat 9

4\. Lastly, run the `systemctl` command below to start and enable the `tomcat9` service, then verify the `tomcat9` service status.

```powershell
# Start and enable tomcat9
sudo systemctl enable --now tomcat9

# Verify tomcat9
sudo systemctl status tomcat9
```

Related:[Controlling Systemd services with Ubuntu systemctl](https://adamtheautomator.com/ubuntu-systemctl/)

The output below shows that the tomcat9 service status is active (running).

![Verifying tomcat9 Service](https://adamtheautomator.com/wp-content/uploads/2022/03/image-476.png)

Verifying tomcat9 Service

## Compiling and Installing Guacamole Server

Since you’ve installed packages dependencies for Apache Guacamole, it’s time to compile and install the Guacamole Server. And the only way to do so is manually from the source code.

To install the Guacamole Server:

1\. Run the `wget` command below to download the source code of Guacamole server v1.4.0 (`guacamole-server-1.4.0.tar.gz`) in your working directory.

> _The latest version of Apache Guacamole is v1.4.0 for both the Guacamole server and client at the time of writing._

```bash
wget https://dlcdn.apache.org/guacamole/1.4.0/source/guacamole-server-1.4.0.tar.gz
```

Related:[How to Download Files with Python Wget](https://adamtheautomator.com/python-wget/)

2\. Next, run the below `tar` command to extract the `guacamole-server-1.4.0.tar.gz` file. This command extracts the Guacamole server source code to the _guacamole-server-1.4.0_ directory.

```adoc
tar -xzf guacamole-server-1.4.0.tar.gz
```

Related:[How to Manage Zip Files in Linux](https://adamtheautomator.com/unzip-files-linux/)

3\. Run each command below to perform the following:

*   Change your working directory (`cd`) to `guacamole-server-1.4.0`.
    
*   Run the `configure` script to set up the Guacamole server. The `configure` script is a Bash script generated by the GNU Autotools build system for setting up the Guacamole server.
    
*   Automatically install (`--with-systemd-dir`) the systemd service script for the Guacamole server to the `/etc/systemd/system/` directory.
    
*   Disable dependency tracking (`--disable-dependency-tracking`) to speed up the build time of the Guacamole server.
    

```bash
# change working directory
cd guacamole-server-1.4.0/

# configure Guacamole server installation and verify system requirements
./configure --with-systemd-dir=/etc/systemd/system/ --disable-dependency-tracking
```

After running the commands, you’ll see an output like the screenshot below.

Notice that all libraries for the Guacamole server installation are installed. You can see that Guacamole supports multiple protocols such as Kubernetes (through WebSocket), RDP, SSH, and VNC.

![Verifying System Requirements](https://adamtheautomator.com/wp-content/uploads/2022/03/image-477.png)

Verifying System Requirements

4\. Now, run the `make` commands below to perform the following:

*   These commands compile the Guacamole server (`make`) on your Linux server.
    
*   Install binary files of the Guacamole server (`make install`) to the `/usr/local/bin` and `/usr/local/sbin` directories.
    
*   Install libraries for the Guacamole server on the `/usr/local/lib` directory.
    

```bash
# Compiling the source code
make

# Installing Guacamole server
make install
```

![Compiling and installing Guacamole Server](https://adamtheautomator.com/wp-content/uploads/2022/03/image-478.png)

Compiling and installing Guacamole Server

5\. Run the below commands to update symbolic links of the system libraries (`ldconfig`), and reload the systemd manager (`daemon-reload`).

These commands don’t have outputs, but ensure your Linux server loads all new Guacamole server libraries and apply the Guacamole server’s new systemd service (guacd).

```bash
# Update symbolic links of the system libraries
sudo ldconfig
# Reload the systemd manager, and apply the new systemd service (guacd)
sudo systemctl daemon-reload
```

6\. Lastly, run the `systemctl` commands below to start and `enable` the Guacamole server service (`guacd`) and verify the `guacd` service is running.

```bash
# Start and enable guacd
sudo systemctl enable --now guacd

# Verify guacd
sudo systemctl status guacd
```

You’ll see in the output below that the Guacamole server service guacd is active (running).

![Verifying guacd Service](https://adamtheautomator.com/wp-content/uploads/2022/03/image-479.png)

Verifying guacd Service

## Creating Guacamole Configuration and Directory

Now that you’ve installed the Guacamole server, it’s time to create a configuration directory (_/etc/guacamole/_) for Apache Guacamole to work.

The _/etc/guacamole/_ directory will store the _guacamole.properties_ and _guacd.conf_ files as the main configuration for Apache Guacamole.

1\. Run the [`echo`](https://www.geeksforgeeks.org/echo-command-in-linux-with-examples/) command below to define the environment variable `GUACAMOLE_HOME` to the Apache Tomcat configuration (`/etc/default/tomcat9`).

This command ensures the `tomcat9` service loads the Guacamole configuration directory (`/etc/guacamole`)

```bash
echo GUACAMOLE_HOME=/etc/guacamole >> /etc/default/tomcat9
```

2\. Now, run the below command to create the Guacamole server configuration directory (`/etc/guacamole`) within additional directories below:

*   The `extensions` directory stores Guacamole extensions.
    
*   The `lib` directory stores libraries the Guacamole server needs.
    

```bash
mkdir -p /etc/guacamole/{extensions,lib}
```

3\. Lastly, run the below command to create Apache Guacamole configuration files (`guacamole.properties` and `guacd.conf`) below:

*   The `guacamole.properties` file is the main configuration for Apache Guacamole.
    
*   The `guacd.conf` file is the configuration for the Guacamole server.
    

```bash
touch /etc/guacamole/{guacamole.properties,guacd.conf}
```

## Setting Up MariaDB Database

At this point, you’ve completed the basic configuration of Apache Guacamole. But, you still need to set up the authentication method for Apache Guacamole. This tutorial uses the MariaDB database for Apache Guacamole authentication.

To set up the MariaDB database for the Apache Guacamole:

1\. First, run the following `mysql` command to log in to the MariaDB shell as the default `root` user. Input the `root` password for the MariaDB server when prompted.

```bash
mysql -u root -p
```

You can tell from the prompt below (**MariaDB \[(none)\]>**) that you’re in the MariaDB shell.

![Logging in to MariaDB Shell](https://adamtheautomator.com/wp-content/uploads/2022/04/image-36.png)

Logging in to MariaDB Shell

2\. Next, run the below MySQL query to create a new database `guacamole_db` and exit from the MariaDB shell.

```bash
CREATE DATABASE guacamole_db;
exit
```

![Creating a Database (guacamole\_db)](https://adamtheautomator.com/wp-content/uploads/2022/04/image-37.png)

Creating a Database (guacamole\_db)

3\. Run the `wget` command below to download the Guacamole database authentication extension.

You’ll need to install the database extension manually and import the database schema to set up database authentication for Apache Guacamole.

```bash
wget https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-auth-jdbc-1.4.0.tar.gz
```

4\. Now run the below commands to extract the file `guacamole-auth-jdbc-1.4.0.tar.gz`, giving you the directory `guacamole-auth-jdbc-1.4.0`.

```bash
# Extract guacamole-auth-jdbc-1.4.0.tar.gz
tar -xf guacamole-auth-jdbc-1.4.0.tar.gz

# Change the working directory
cd guacamole-auth-jdbc-1.4.0/mysql/
```

5\. Run the [`cat`](https://linuxize.com/post/linux-cat-command/) command below to import the Apache Guacamole MariaDB database schema (`schema/*.sql`) to the `guacamole_db` database.

The MariaDB database schema is used for multiple [RDBMS](https://www.tutorialspoint.com/sql/sql-rdbms-concepts.htm), such as MariaDB/MySQL, PostgreSQL, and SQL Server.

```bash
# Check if the Apache Guacamole MariaDB database schema exists
ls
# Import the database schema (schema/*.sql) to the guacamole_db database
cat schema/*.sql | mysql -u root -p guacamole_db
```

Enter the MariaDB’s root user’s password when prompted, as shown below.

![Importing database schema to guacamole\_db](https://adamtheautomator.com/wp-content/uploads/2022/04/image-38.png)

Importing database schema to guacamole\_db

6\. Now, rerun the `mysql` command below to log in to the MariaDB shell. You’ll set up a new MariaDB user for the Apache Guacamole.

```powershell
mysql -u root -p
```

![Logging into MariaDB Shell](https://adamtheautomator.com/wp-content/uploads/2022/04/image-39.png)

Logging into MariaDB Shell

7\. Lastly, run the MariaDB queries below to create a database user for the `guacamole_db` database.

```bash
# Create a new user called guacamole_user. 
# Make sure to change the password with a strong password.
CREATE USER 'guacamole_user'@'localhost' IDENTIFIED BY 'StrongPassword';
# Allow the user guacamole_user to access the guacamole_db database.
GRANT SELECT,INSERT,UPDATE,DELETE ON guacamole_db.* TO 'guacamole_user'@'localhost';
# Reload privileges from the privilege tables
FLUSH PRIVILEGES;
# Exit from MariaDB shell.
exit
```

![Setting up a Database User for guacamole\_db](https://adamtheautomator.com/wp-content/uploads/2022/04/image-40.png)

Setting up a Database User for guacamole\_db

## Installing Database Authentication Extension and MySQL/J Library

You’ve now created the MariaDB database and user for Apache Guacamole. Next, you will be installing the Guacamole database authentication extension and the [MySQL/J](https://dev.mysql.com/downloads/connector/j/) connector for the database driver.

The Guacamole database authentication extensions allow you to set up Apache Guacamole with database authentication, such as MySQL/MariaDB and PostgreSQL. And the MySQL/J connector library is used to connect to the MySQL/MariaDB database.

1\. Run the below commands to change the working directory to `guacamole-auth-jdbc-1.4.0/mysql/`, and list the files inside the working directory.

```bash
# change working directory
cd guacamole-auth-jdbc-1.4.0/mysql/

# check list files
ls -lah
```

Like the one below, you’ll see the Guacamole database authentication extension (**guacamole-auth-jdbc-mysql-1.4.0.jar**).

![Verifying the Guacamole Authentication Extension](https://adamtheautomator.com/wp-content/uploads/2022/04/image-41.png)

Verifying the Guacamole Authentication Extension

2\. Next, run the [`cp`](https://www.geeksforgeeks.org/cp-command-linux-examples/) command below to install the Guacamole database authentication extension (`guacamole-auth-jdbc-mysql-1.4.0.jar`) to the `/etc/guacamole/extensions/` directory.

This command installs and enables the MariaDB/MySQL extensions for the Apache Guacamole.

```bash
cp guacamole-auth-jdbc-mysql-1.4.0.jar /etc/guacamole/extensions/guacamole-auth-jdbc-mysql.jar
```

![Installing Guacamole Database Authentication Extension](https://adamtheautomator.com/wp-content/uploads/2022/04/image-42.png)

Installing Guacamole Database Authentication Extension

3\. Run the `wget` command below to download the MySQL/J connector (library) for Java (`mysql-connector-java_8.0.28-1ubuntu20.04_all.deb`).

The Guacamole database authentication extensions will connect to the MariaDB database server using this Java library.

```bash
wget https://cdn.mysql.com//Downloads/Connector-J/mysql-connector-java_8.0.28-1ubuntu20.04_all.deb
```

4\. Now, run the [`dpkg`](https://manpages.ubuntu.com/manpages/xenial/en/man1/dpkg.1.html) command below to manually install the MySQL/J connector (`mysql-connector-java_8.0.28-1ubuntu20.04_all.deb`) to your Ubuntu system.

This command installs the MySQL/J library to the `/usr/share/java` directory.

```bash
dpkg -i mysql-connector-java_8.0.28-1ubuntu20.04_all.deb
```

5\. Lastly, run the below command to copy the MySQL/J connector library to the /etc/guacamole/lib/ directory. This command allows the Apache Guacamole to use the MySQL/J library to connect to the MariaDB database.

```bash
# copy the MySQL/J connector
cp /usr/share/java/mysql-connector-java-8.0.28.jar /etc/guacamole/lib/mysql-connector.jar
```

![Installing MySQL/J connector library](https://adamtheautomator.com/wp-content/uploads/2022/04/image-43.png)

Installing MySQL/J connector library

## Configuring Apache Guacamole with MariaDB Database

You’ve now installed the Guacamole database authentication extension and the MySQL/J connector. But they’re not doing much unless you apply the database authentication.

You’ll apply the Guacamole database authentication through the Guacamole configuration (`guacamole.properties`). You’ll also set up the guacd binding IP address and port using the `guacd.conf` configuration.

1\. Edit the _/etc/guacamole/guacamole.properties_ file using your preferred editor and populate the configuration below.

Be sure to input the correct MariaDB user, password, and database name. Apache Guacamole will use this configuration to connect to the MariaDB database.

```powershell
mysql-hostname: localhost
mysql-port: 3306
mysql-database: guacamole_db
mysql-username: guacamole_user
mysql-password: StrongPassword
```

2\. Next, edit the _/etc/guacamole/guacd.conf_ file and populate the following configuration.

This configuration runs the guacd service on the bind-address `0.0.0.0` or any IP address on the server with the default TCP port `4822`.

```powershell
[server]
bind_host = 0.0.0.0
bind_port = 4822
```

Lastly, run the `systemctl` command below to reload the `guacd` and `tomcat9` services and apply new changes.

```bash
# restart guacd
sudo systemctl restart guacd

# restart tomcat9
sudo systemctl restart tomcat9
```

## Installing the Guacamole Client Web Application

At this point, you’ve completed the Guacamole server installation with the MariaDB database authentication extension. You’ll now install the Guacamole client, the front-end of the Apache Guacamole software stack.

This tutorial uses the pre-built Guacamole client package (`guacamole.war`) from the official [Guacamole download page](https://guacamole.apache.org/releases/1.4.0/).

Run the `wget` command below to download the full package (`guacamole-1.4.0.war`) of the Guacamole web application v1.4.0.

> _The latest version of the Guacamole web application is v1.4.0 as of this writing._

```bash
wget <https://dlcdn.apache.org/guacamole/1.4.0/binary/guacamole-1.4.0.war>
```

![Downloading the Guacamole Web Application Package](https://adamtheautomator.com/wp-content/uploads/2022/04/image-44.png)

Downloading the Guacamole Web Application Package

Now, run each command below to move and install the file `guacamole-1.4.0.war` to the `/var/lib/tomcat9/webapps` directory. This action makes the Guacamole client accessible from the path URL (`/guacamole/`).

```bash
# Rename guacamole-1.4.0.war to guacamole.war
mv guacamole-1.4.0.war guacamole.war

# Copy guacamole.war
cp guacamole.war /var/lib/tomcat9/webapps

# Verify guacamole.war
ls /var/lib/tomcat9/webapps
```

![Installing Guacamole Client](https://adamtheautomator.com/wp-content/uploads/2022/04/image-45.png)

Installing Guacamole Client

## Setting Up Apache as a Reverse Proxy for Guacamole Client

After installing the Guacamole client on your server, you’ll need to install and configure the Apache webserver with an Apache virtual host configuration. You’ll enable the Apache webserver as a reverse proxy for the Guacamole client.

1\. Follow the [certbot documentation](https://eff-certbot.readthedocs.io/en/stable/using.html#standalone) to generate free LetsEncrypt SSL certificates for your domain name. SSL certificates will secure and encrypt your connection to the Guacamole client web application.

2\. Next, run the `apt` command below to install the Apache webserver.

```bash
sudo apt install apache2 -y
```

![Installing Apache2](https://adamtheautomator.com/wp-content/uploads/2022/04/image-46.png)

Installing Apache2

3\. Once installed, run the [`a2enmod`](https://manpages.ubuntu.com/manpages/trusty/man8/a2enmod.8.html) command below to enable modules for the Apache reverse proxy. `sudo a2enmod proxy proxy_wstunnel proxy_http ssl rewrite` ![Enabling apache2 modules](https://s3-us-west-2.amazonaws.com/secure.notion-static.com/a859798e-2ae3-4448-8c59-36378cdaf1c2/10-activate-aache-modules.png) Enabling apache2 modules

```bash
sudo a2enmod proxy proxy_wstunnel proxy_http ssl rewrite
```

![Enabling apache2 modules](https://adamtheautomator.com/wp-content/uploads/2022/04/image-47.png)

Enabling apache2 modules

4\. Now, create a new virtual host configuration file (`/etc/apache2/sites-available/guacamole.conf`) and populate the below configuration.

Change the `example.io` domain name with your domain name and the path of SSL certificates (`/etc/letsencrypt/live/example.io/`) with your SSL path.

This Apache virtual host configuration enables a reverse proxy for the Guacamole client web application. The client web application runs under the Apache Tomcat on port `8080` with URL path `/guacamole`.

```powershell
<VirtualHost *:80>
    ServerName example.io
    ServerAlias www.example.io

    Redirect permanent / https://example.io/
</VirtualHost>

<VirtualHost *:443>
    ServerName example.io
    ServerAlias www.example.io

    <If "%{HTTP_HOST} == 'www.example.io'">
    Redirect permanent / https://example.io/
    </If>

    ErrorLog /var/log/apache2/example.io-error.log
    CustomLog /var/log/apache2/example.io-access.log combined

    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem

    <Location /guacamole/>
        Order allow,deny
        Allow from all
        ProxyPass http://127.0.0.1:8080/guacamole/ flushpackets=on
        ProxyPassReverse http://127.0.0.1:8080/guacamole/
    </Location>

    <Location /guacamole/websocket-tunnel>
        Order allow,deny
        Allow from all
        ProxyPass ws://127.0.0.1:8080/guacamole/websocket-tunnel
        ProxyPassReverse ws://127.0.0.1:8080/guacamole/websocket-tunnel
    </Location>

</VirtualHost>
```

5\. Run each command below to activate the `guacamole.conf` virtual host configuration and verify the Apache configuration. `# activate guacamole.conf a2ensite guacamole.conf # verify apache2 configuration apachectl configtest`

```bash
# activate guacamole.conf
a2ensite guacamole.conf

# verify apache2 configuration
apachectl configtest
```

If your configuration has no error, you’ll see a **Syntax OK** message output, like the one below.

![Setting up apache2 Reverse Proxy for Guacamole](https://adamtheautomator.com/wp-content/uploads/2022/04/image-48.png)

Setting up apache2 Reverse Proxy for Guacamole

6\. Next, edit the Tomcat configuration (`/etc/tomcat9/server.xml`) and populate the following configuration inside the `<Host>` section.

This configuration allows an application within Tomcat to see the real IP address of the client. You’ll need this configuration because the main application Guacamole client is behind the Apache reverse proxy.

```xml
<Valve className="org.apache.catalina.valves.RemoteIpValve"
            internalProxies="127.0.0.1"
            remoteIpHeader="x-forwarded-for"
            remoteIpProxiesHeader="x-forwarded-by"
            protocolHeader="x-forwarded-proto" />
```

![Setting up tomcat9 Server.xml](https://adamtheautomator.com/wp-content/uploads/2022/04/image-49.png)

Setting up tomcat9 Server.xml

7\. Lastly, run the `systemctl` command below to restart `apache2` and `tomcat9` services and apply new changes.

```bash
# Restart apache2
sudo systemctl restart apache2

# Restart tomcat9
sudo systemctl restart tomcat9
```

## Verifying Apache Guacamole

You’ve now completed Apache Guacamole installation with Apache2 reverse proxy. But how do you know installation works? You’ll verify the installation by accessing the Apache Guacamole from a web browser.

Open your web browser and input the domain name for Apache Guacamole installation followed by the URL path _/guacamole_ (i.e., https://example.io/guacamole). If all configurations are correct, you’ll get the login page of the Apache Guacamole web application, as shown below.

Input the default user `guacadmin` and the password `guacadmin`, then click the **Login** button.

![gging in to Apache Guacamole](https://adamtheautomator.com/wp-content/uploads/2022/04/image-50.png)

Logging in to Apache Guacamole

After logging in, you’ll see the blank page of the Apache Guacamole admin dashboard shown below.

![Viewing Guacamole user Dashboard](https://adamtheautomator.com/wp-content/uploads/2022/04/image-51.png)

Viewing Guacamole user Dashboard

Next, click the user (**guacadmin)** on the top right, then select **Settings** to access the user account settings.

![Accessing Guacamole User Settings](https://adamtheautomator.com/wp-content/uploads/2022/04/17guacamole-settings-1.png)

Accessing Guacamole User Settings

As you see below, you can change the default password for **guacadmin** user, create a new user, create new remote desktop connections, and set up the Apache Guacamole itself.

![Guacamole System Settings](https://adamtheautomator.com/wp-content/uploads/2022/04/image-52.png)

Guacamole System Settings

## Conclusion

Throughout this tutorial, you’ve learned to install Apache Guacamole as a remote desktop gateway with MariaDB database authentication and the Apache reverse proxy. At this point, you already have a fully functional remote desktop gateway.

Now, why not explore integration with [CAS authentication](https://guacamole.apache.org/doc/gug/cas-auth.html) and the [basic administration](https://guacamole.apache.org/doc/gug/administration.html) for Apache Guacamole? Check the official [Guacamole Documentation](https://guacamole.apache.org/doc/gug/) to learn more about Apache Guacamole.

Share this article

[Share on X](https://twitter.com/intent/tweet?url=https%3A%2F%2Fadamtheautomator.com%2Fapache-guacamole%2F&text=How%20to%20Install%20the%20Apache%20Guacamole%20Remote%20Desktop%20Gateway)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fadamtheautomator.com%2Fapache-guacamole%2F)[Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fadamtheautomator.com%2Fapache-guacamole%2F)

## Related Posts

![](https://adamtheautomator.com/wp-content/uploads/2026/06/26995-troubleshoot-dns-issues-powershell-codex.webp)

### [Troubleshoot DNS Issues with PowerShell](/troubleshoot-dns-issues-powershell/)

Troubleshoot DNS issues with PowerShell by testing name resolution, DNS client settings, cache entries, and network connectivity in a repeatable workflow.

![](https://adamtheautomator.com/wp-content/uploads/2024/04/idfix.jpg)

### [Solve Azure AD Connect Errors via the Microsoft IdFix Tool](/idfix/)

Fix Azure AD Connect errors fast with the Microsoft IdFix tool—your go-to solution for seamless synchronization and efficient directory management!

![](https://adamtheautomator.com/wp-content/uploads/2022/11/windows-server-storage.jpg)

### [Getting Started with Windows Server Storage](/windows-server-storage/)

Learn everything you need to know about Windows Server Storage in this in-depth tutorial by ATA Learning and manage your storage like a pro!

## Categories

*   [IT Ops](/category/it-ops/)
*   [Cloud](/category/cloud/)
*   [DevOps](/category/devops/)
*   [Home Ops](/category/home-ops/)
*   [Information Security](/category/infosec/)
*   [Software Development](/category/software-development/)

## Site

*   [Home](/)
*   [Tutorials](/tutorials/)
*   [Instructors](/author/)
*   [Advertising](/advertising/)
*   [Recommended Resources](/resources/)
*   [About Adam](/about-adam/)

Copyright 2026© ATA Learning | [Privacy Policy](/privacy/)