Skip to main content

Upgrading Guacamole

The steps below cover upgrading Guacamole through Docker. It is recommended that if Guacamole was installed directly on the server using RPM packages, remove the RPM packages and install Guacamole using the Docker method instead.

Packages are available for Red Hat Enterprise Linux (RHEL) versions 8 and 9. Ensure that your server supports these packages prior to upgrading.

Caution

Any customizations done during installation using Docker will be overridden by this reinstallation. Ensure that you document your setup so that it can be replicated after upgrade.

  1. On the Guacamole gateway, rename the idmunix-rhel-el*.x64 directory to idmunix-rhel-el*.x64.old, where * is the RHEL version.

  2. Copy over the idmunix-rhel-el8.x64.tar.gz or idmunix-rhel-el9.x64.tar.gz file from the <instance>\addon\idmunix directory to a temporary folder on the Guacamole gateway.

  3. Unzip the .tar.gz file.

  4. Open the idmunix-rhel-el*.x64\docker directory, where * is the RHEL version.

  5. Build and run the Docker images:

    docker-compose up --force-recreate --build -d

  6. Remove the older images:

    docker image prune -f
In this section: