guacd (8) - Linux Manuals

guacd: Guacamole proxy daemon

Command to display guacd manual in Linux: $ man 8 guacd

NAME

guacd - Guacamole proxy daemon

SYNOPSIS

guacd [-b HOST] [-l PORT] [-p PID FILE] [-L LOG LEVEL] [-C CERTIFICATE FILE] [-K KEY FILE] [-f]

DESCRIPTION

guacd is the Guacamole proxy daemon used by the Guacamole web application and framework. As JavaScript cannot handle binary protocols (like VNC and remote desktop) efficiently, a new text-based protocol was developed which would contain a common superset of the operations needed for efficient remote desktop access, but would be easy for JavaScript programs to process. guacd is the proxy which translates between arbitrary protocols and the Guacamole protocol.

OPTIONS

-b HOST: Changes the host or address that guacd listens on.
-l PORT: Changes the port that guacd listens on (the default is port 4822).
-p FILE: Causes guacd to write the PID of the daemon process to the specified file. This is useful for init scripts and is used by the provided init script.
-L LEVEL: Sets the maximum level at which guacd will log messages to syslog and, if running in the foreground, the console. Legal values are debug, info, warning, and error. The default value is info.
-f: Causes guacd to run in the foreground, rather than automatically forking into the background.

SSL/TLS OPTIONS

If libssl was present at the time guacd was compiled, it will contain SSL/TLS support, and connections between the web application and guacd can be encrypted if a certificate file is given.

When using a chain of certificates, you must append the additional certificates to your server certificate. This can be done easily with the standard cat command. Beware that the certificate for guacd must be the first certificate in the file.

-C CERTIFICATE FILE: Enables SSL/TLS using the given cerficiate file. Future connections to this instance of guacd will require SSL/TLS enabled in the client (the web application). If this option is not given, communication with guacd must be unencrypted.
-K KEY FILE: Enables SSL/TLS using the given private key file. Future connections to this instance of guacd will require SSL/TLS enabled in the client (the web application). If this option is not given, communication with guacd must be unencrypted.

AUTHOR

Written by Michael Jumper <mike.jumper [at] guac-dev.org>