GUACAMOLE-2301: Add serial console protocol support (web client) - #1230
Open
ciroiriarte wants to merge 5 commits into
Open
GUACAMOLE-2301: Add serial console protocol support (web client)#1230ciroiriarte wants to merge 5 commits into
ciroiriarte wants to merge 5 commits into
Conversation
Add the serial connection-parameter form (serial.json) and English translations (PROTOCOL_SERIAL) for the new guacd serial protocol, mirroring the telnet/ssh forms and the IPMI feature branch's translation conventions. Also add a minimal "Send Break" menu control, surfaced only for serial connections, that opens the server's "serial-control" pipe stream and writes the literal command "break", mirroring the pipe- stream idiom already used by ManagedClient.setClipboard/sendArguments.
… controls Adds the auto-reconnect, line-ending, local-echo, and hangup-on-close connection parameters, and DTR/RTS control-line buttons in the serial console menu (writing dtr-on/dtr-off/rts-on/rts-off to the serial-control pipe, reusing the Send Break mechanism).
…ROTOCOLS The serial protocol descriptor (serial.json) and translations were present, but Guacamole enumerates available protocols from the hardcoded KNOWN_PROTOCOLS list in LocalEnvironment, not from the descriptors on the classpath. Without a "serial" entry there, serial.json was never loaded, so the protocol was absent from the connection-editor's protocol dropdown and the admin form could not be used to create serial connections (runtime connections via user-mapping were unaffected). Add "serial" to KNOWN_PROTOCOLS so the connection form renders.
Expose the reverse (listen) mode parameters in the serial connection form and English translation: reverse-connect, bind-address, and listen-timeout, grouped under the Network section.
Add the telnet transport to the network-protocol choices in the serial connection form and English translation.
This was referenced Jul 17, 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.
Summary
Web-client support for the new
serialconsole protocol (GUACAMOLE-2301), the companion to the guacamole-server PR. Adds the connection form, translations, and protocol registration so serial connections can be created and used from the Guacamole web interface.Changes
serial.json) covering connection type and network protocol (raw/rfc2217/telnet), local device, network host/port, reverse-mode (reverse-connect,bind-address,listen-timeout), serial line settings (baud, data/stop bits, parity, flow control, line ending), features (break duration, paste delay, local echo, hangup-on-close), display, clipboard, recording, and typescript sections.serialinLocalEnvironment's known protocols so the connection editor lists it.Testing
The serial connection form was exercised in the administration interface (all sections render; the network-protocol list includes Raw/RFC 2217/Telnet; the reverse-mode fields appear), and connections were driven end-to-end through the browser against real hardware and a QEMU virtual serial console. Evidence is attached to GUACAMOLE-2301.
Coordinated PRs