Title

(Written June 2025)

Abstract

How to install Guacamole, a clientless remote desktop gateway, using docker compose. To make a bit easier, we'll be using guacamole-docker-compose

Prerequisites

• Ubuntu virtual machine
• Docker Compose installed

Hardware requirements

• RAM: Minimum 1GB.
• CPU: Minimum 1 cores, recommended 2 cores.
• Storage: Minimum 8 Gb

Install Guacamole

Step 1: Clone the GIT repo

cd /home
mkdir docker
cd docker

git clone "https://github.com/boschkundendienst/guacamole-docker-compose.git"

Step 2: Adjust yaml file

Navigate to the docker-compose.yml file

nano guacamole-docker-compose/docker-compose.yml

Info

Choose a strong Postgres password (you need to set it twice in the yaml config)

Step 3: Build and start

./prepare.sh

docker compose up -d

Step 4: Connect to Guacamole

https://yourIP:8443

The default credentials are 'guacadmin' with password 'guacadmin'.

Step 5: Users

Go to Settings > Users Create your own user with all the necessary privileges.

Warning

Go login with that user and DELETE the default 'guacadmin' user!