Skip to main content

Frequently Asked Questions

How can I enable file download and upload?

Connections support uploading and downloading files from the browser. This feature can be enabled on a connection and is not enabled by default.

To enable file transfer for RDP connection, open the connection in the connection settings and enable Enable drive under Drive Redirection. After connecting to the instance, a new share drive will show up under the name Sharing on Guacamole RDP. This share drive will contain files that you drag and drop into the browser window. You can download any file by moving it into the Download folder within the share drive.

For SSH connections, edit the connection preferences and enable Enable SFTP. You can then either upload files via drag and drop (they will appear in the home directory of the current user) or use the file explorer by pressing Shift + Alt + Ctrl.

Why am I prompted for a Key Passphrase when connecting via SSH, even though the private key is not encrypted?

The key format you are using for the private is most likely not supported by Guacamole. Make sure that the first line of your private key is -----BEGIN RSA PRIVATE KEY-----. You can use the ssh-keygen utility to convert a key from a different format in to the PEM format:

ssh-keygen -f ~/.ssh/id_rsa -p -m pem

How can I connect to a instance running Windows Server 2016 and later?

Windows Server 2016 and alter made some changes to the way remote authentication works. The interactive log in screen is no longer supported which means that the username and password must be provided when the connection is established. To do this, edit the connection parameters, set the username and password and set the Security Mode to NLA.

Why do I get a "you do not have permission to upload this file" error message when trying to upload files?

Make sure that the Drive Path in the connection settings is set to /tmp/guacd.