Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

GUACAMOLE-1499: Mention some caveats with VNC #181

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions src/configuring-guacamole.md
Original file line number Diff line number Diff line change
Expand Up @@ -435,6 +435,10 @@ VNC support for Guacamole is provided by the libguac-client-vnc library, which
will be installed as part of guacamole-server if the required dependencies are
present during the build.

VNC by itself does not provide file transfer, so you must use sftp (as
described in [](common-sftp)) if you want to provide file upload or
download in Guacamole.

:::{note}
In addition to the VNC-specific parameters below, Guacamole's VNC support also
accepts the parameters of several features that Guacamole provides for multiple
Expand Down Expand Up @@ -750,6 +754,12 @@ only be accessed via VNC, one of these is likely your best choice. Both
optimize window movement and (depending on the application) scrolling, giving a
very responsive user experience.

On Ubuntu Linux version 18.04, the package
`tigervnc-standalone-server` does not support clipboard (copy/paste)
functionality. The `tigervncserver` packages provided by the TigerVNC
project (https://sourceforge.net/projects/tigervnc/files/stable/) do
support clipboard operations.

Comment on lines +757 to +762
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

My thought, here, is that, instead of trying to cover what the capabilities of specific distributions, versions, and VNC servers support, it might be better go more generic. Something more like Your distribution and VNC server may not support clipboard functionality - please check the documentation or locate a VNC server/version that does.

I'm just not sure the Guacamole Manual is the place to try to document (and keep up-to-date) the capabilities of various distributions and VNC servers. I don't think that'll scale well :-).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, I hear you. But there is not other documentation to check, and how is one supposed to "find one that does". I don't know what causes a VNC server to have clipboard functionality that works or doesn't with guacamole, but it's certainly not something they document in a clear way! Would a "known good" / "known missing some functionality" list be more palatable? It would at least be less wordy.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I'd be okay with a couple of lists like that - these VNC servers are known to work, these are not, etc.

##### TightVNC

TightVNC is widely-available and performs generally as well as RealVNC or
Expand Down