Secure Remote Desktop: Install & Configure Apache Guacamole on Ubuntu 24.04

Looking for a secure, web-based remote desktop solution for your Ubuntu 24.04 system? Apache Guacamole is the perfect choice! This powerful, open-source tool allows you to access your desktop, SSH, and RDP servers from any device without needing client software. Whether you're managing servers or working remotely, Guacamole offers seamless, secure, and clientless remote access via your web browser.

In this guide, you'll learn how to install and configure Apache Guacamole on Ubuntu 24.04 in just a few simple steps.

Why Choose Apache Guacamole for Remote Access?

Apache Guacamole is a popular remote desktop gateway because of its clientless architecture and robust security features. With Guacamole, you only need a web browser to access your desktop or servers remotely.

Key Features:

  • Clientless Access – No software required on client devices
  • Supports Multiple Protocols – RDP, SSH, and VNC
  • Built-in Encryption – Secure remote access
  • Cross-Platform Compatibility – Works on Windows, Linux, and MacOS
  • Multi-User Support – Manage users with different permissions

Step 1: Update System Packages

Before installing Guacamole, make sure your Ubuntu system is up to date.

sudo apt update && sudo apt upgrade -y

Step 2: Install Required Dependencies

Guacamole requires several dependencies to run. Install them using the following command:

sudo apt install -y tomcat9 tomcat9-admin openjdk-17-jdk gcc libcairo2-dev libjpeg-turbo8-dev libpng-dev libossp-uuid-dev libavcodec-dev libavformat-dev libavutil-dev libswscale-dev

Step 3: Download and Install Apache Guacamole

Download the latest version of Apache Guacamole Server:

wget https://downloads.apache.org/guacamole/1.5.0/source/guacamole-server-1.5.0.tar.gz

tar -xvzf guacamole-server-1.5.0.tar.gz

cd guacamole-server-1.5.0

Configure and install the server:

./configure --with-systemd

make

sudo make install

sudo ldconfig

Step 4: Configure Guacamole

Create the Guacamole configuration folder:

sudo mkdir /etc/guacamole

sudo nano /etc/guacamole/guacamole.properties

Add the following lines:

guacd-hostname: localhost 

guacd-port: 4822 

auth-provider: simple 

basic-user-mapping: /etc/guacamole/user-mapping.xml

Step 5: Create User Authentication File

Now, create a user mapping file to define users and passwords:

sudo nano /etc/guacamole/user-mapping.xml

Add this content:

<user-mapping>

    <authorize username="admin" password="password">

        <connection name="Ubuntu Server">

            <protocol>ssh</protocol>

            <param name="hostname">localhost</param>

            <param name="port">22</param>

        </connection>

    </authorize>

</user-mapping>

Step 6: Restart Services

Restart the Guacamole and Tomcat services:

sudo systemctl restart tomcat9

sudo systemctl enable guacd

sudo systemctl start guacd

Step 7: Access Apache Guacamole Web Interface

Open your browser and go to:

http://your-server-ip:8080/guacamole

Log in with the username and password you set in the user-mapping file.

Conclusion

With Apache Guacamole installed on Ubuntu 24.04, you now have a secure, browser-based remote desktop gateway ready for remote access. This setup not only improves convenience but also enhances security by eliminating the need for third-party client software.

Would you like to enable two-factor authentication or secure your Guacamole instance with SSL? Let us know in the comments!

source: orcacore.com/installing-apache-guacamole-on-ubuntu-24-04

Comments

Popular posts from this blog

FastAPI & MongoDB on Ubuntu 24.04 – The Ultimate Setup Guide

Secret Android Battery-Saving Features You Should Be Using!

Fix SSL Issues: How to Install OpenSSL on Windows Server 2025