On Sun, Nov 16, 2025 at 3:32 PM Makarem Dandouna
<[email protected]> wrote:
>
> Hello,
> I would like to know if there is a way to customize the error messages shown 
> to users in the Guacamole web interface without having to rebuild the source 
> code.
> For example, if the connection first goes through a jumpbox. If the jumpbox 
> is powered off, an extension automatically starts it as soon as the user 
> initiates a connection. Instead of simply displaying that the VM is 
> unreachable during this startup time, I would like to show a more 
> user-friendly message informing the user that the jumpbox is starting up and 
> he just need to wait.
> Is there an existing mechanism or recommended approach for customizing these 
> messages ?

Yes, you can use the same mechanism for accomplishing this as you
would for implementing custom branding - you essentially create an
extension and, in the translation file(s) for that extension, you
specify the strings that you want to replace. For example, if you want
to replace one of the errors that references the remote server being
unavailable 
(https://github.com/apache/guacamole-client/blob/93f98170191a37136c931ad118ff73c644475f13/guacamole/src/main/frontend/src/translations/en.json#L89),
you'd do something like this:

{
  "CLIENT" : {
    "ERROR_CLIENT_207" : "The remote system is currently unavailable,
but may be booting up. Please give it a few minutes and try, again."
  }
}

See the following links:
https://guacamole.apache.org/doc/gug/guacamole-ext.html
https://github.com/apache/guacamole-client/tree/main/doc/guacamole-branding-example

-Nick

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to