1guacd(8)                       Apache Guacamole                       guacd(8)
2
3
4

NAME

6       guacd - Guacamole proxy daemon
7

SYNOPSIS

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

DESCRIPTION

13       guacd is the Guacamole proxy daemon used by the Guacamole web  applica‐
14       tion  and framework. As JavaScript cannot handle binary protocols (like
15       VNC and remote desktop) efficiently, a new text-based protocol was  de‐
16       veloped  which would contain a common superset of the operations needed
17       for efficient remote desktop access, but would be easy  for  JavaScript
18       programs to process.  guacd is the proxy which translates between arbi‐
19       trary protocols and the Guacamole protocol.
20

OPTIONS

22       -b HOST
23              Changes the host or address that guacd listens on.
24
25       -l PORT
26              Changes the port that guacd listens  on  (the  default  is  port
27              4822).
28
29       -p FILE
30              Causes guacd to write the PID of the daemon process to the spec‐
31              ified file. This is useful for init scripts and is used  by  the
32              provided init script.
33
34       -L LEVEL
35              Sets  the maximum level at which guacd will log messages to sys‐
36              log and, if running in the foreground, the console.  Legal  val‐
37              ues  are  trace,  debug,  info, warning, and error.  The default
38              value is info.
39
40       -f     Causes guacd to run in the foreground, rather than automatically
41              forking into the background.
42
43       -v     Causes guacd to simply print its version information and exit.
44

SSL/TLS OPTIONS

46       If  libssl  was present at the time guacd was compiled, it will contain
47       SSL/TLS support, and connections between the web application and  guacd
48       can be encrypted if a certificate file is given.
49
50       When using a chain of certificates, you must append the additional cer‐
51       tificates to your server certificate. This can be done easily with  the
52       standard cat command. Beware that the certificate for guacd must be the
53       first certificate in the file.
54
55       -C CERTIFICATE FILE
56              Enables SSL/TLS using the given cerficiate file. Future  connec‐
57              tions  to this instance of guacd will require SSL/TLS enabled in
58              the client (the web application). If this option is  not  given,
59              communication with guacd must be unencrypted.
60
61       -K KEY FILE
62              Enables SSL/TLS using the given private key file. Future connec‐
63              tions to this instance of guacd will require SSL/TLS enabled  in
64              the  client  (the web application). If this option is not given,
65              communication with guacd must be unencrypted.
66

SEE ALSO

68       guacd.conf(5)
69
70
71
72version 1.5.4                     1 Jun 2017                          guacd(8)
Impressum