GUACAMOLE-2064: Add UI support for database terminal protocols#1229
Open
4m1nr wants to merge 1 commit into
Open
GUACAMOLE-2064: Add UI support for database terminal protocols#12294m1nr wants to merge 1 commit into
4m1nr wants to merge 1 commit into
Conversation
Register the five new database terminal protocols (MySQL, PostgreSQL, SQL Server, MongoDB, and Oracle) provided by guacamole-server so that they can be configured through the Guacamole web interface. Each protocol is added to the list of known protocols and given a connection-parameter form describing its network, authentication, encryption, terminal display, clipboard, behavior, typescript, session recording, and Wake-on-LAN options, mirroring the existing terminal protocols. English translation strings are provided for every field, option, and section, and the terminal icon is associated with each new protocol.
This was referenced Jul 14, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this does
Adds the web-interface support for the five new database terminal protocols
(MySQL, PostgreSQL, SQL Server, MongoDB, Oracle) implemented in
guacamole-server for
GUACAMOLE-2064, so that
connections using them can be created and configured from the Guacamole admin
UI.
Changes
LocalEnvironment.java— the five protocol names are added toKNOWN_PROTOCOLSso their bundled connection-parameter definitions areloaded.
guacamole-ext/…/protocols/{mysql,postgresql,mssql,mongodb,oracle}.json,modeled on
telnet.json. Each describes the relevant field groups —network, authentication, encryption (TLS/SSL), terminal display, clipboard,
behavior, typescript, session recording, and Wake-on-LAN — using the existing
field types (
TEXT,NUMERIC,USERNAME,PASSWORD,BOOLEAN,ENUM,TERMINAL_COLOR_SCHEME). Per-database differences are reflected: MySQL/PGexpose their respective
ssl-modevalue sets, SQL Server exposestds-version, MongoDB exposesauth-databaseand a booleanuse-ssl, andOracle uses
service-namein place ofdatabase.en.json— full English translations for every field header, ENUMoption, and section header of all five protocols, plus each protocol's
display
NAME. (Coverage was checked by canonicalizing every form field toits expected translation key — 0 missing.)
ui.css— the terminal icon (guac-text.svg) is associated with each newprotocol, matching SSH/telnet/Kubernetes.
Only English strings are added; other locales fall back to English as usual.
No database-schema or JDBC-extension changes are required — connections store
the protocol as a free-form string.
Testing
mvn -pl guacamole-ext -am testpasses.mvn -pl guacamole -am package(webpack WAR build) succeeds.translation key.
connection of each new type. (Screenshots can be added on request.)
Related PRs
Part of a three-repo change under GUACAMOLE-2064: