Repolode
Submit
apache

apache/guacamole-server

The guacd proxy daemon, libguac C API and protocol libraries that translate RDP, VNC, SSH and Telnet into Guacamole's browser-friendly protocol.

View on GitHubWebsite
Stars
4,015
Forks
816
Open issues
77
Last commit
5 days ago

What is it?

guacamole-server is the native back end of the Apache Guacamole remote desktop gateway. It contains guacd, a proxy daemon that connects to remote systems over binary protocols such as VNC and RDP and translates them into Guacamole's text-based protocol, which a web client can process easily.

The repository also includes libguac, the C API used to build protocol support, and several protocol libraries. The README lists optional support for RDP via FreeRDP, SSH and Telnet, VNC via libVNCserver, SFTP file transfer, WebP compression, and video encoding with guacenc through FFmpeg. Building uses the standard Automake configure, make and make install workflow, and guacd runs with configurable host, port, pidfile and log-level options.

Key features

  • 01Proxies RDP, VNC, SSH and Telnet connections into the Guacamole protocol.
  • 02Provides libguac, a C API for building protocol support.
  • 03Supports optional SFTP file transfer for VNC and RDP sessions.
  • 04Supports optional audio over VNC via PulseAudio.
  • 05Builds with the standard configure, make and make install workflow.

Use cases

  • Running a clustered or self-hosted browser-based remote desktop gateway.
  • Providing browser access to internal SSH, VNC or RDP hosts without client software.
  • Building or packaging the guacd backend for a Guacamole web deployment.

Quick start

  1. 1

    Install the required dependencies (Cairo, libjpeg-turbo, libpng, OSSP UUID) and the protocol libraries you need

  2. 2

    Run configure

    ./configure
  3. 3

    Build with make

    make
  4. 4

    Install as root

    make install
  5. 5

    Run guacd directly

    guacd

Things to know

  • Must be compiled from source using Automake; no package-manager install is given in the README.
  • Requires several C libraries to be installed before building.
  • guacd is only a proxy daemon and needs the separate Guacamole web application to be useful.

Topics

#remote-desktop#vnc#rdp#ssh#proxy#guacamole#java#javascript#network-client#network-server

FAQ

What is guacamole-server?
The guacd proxy daemon, libguac C API and protocol libraries that translate RDP, VNC, SSH and Telnet into Guacamole's browser-friendly protocol. guacamole-server is the native back end of the Apache Guacamole remote desktop gateway. It contains guacd, a proxy daemon that connects to remote systems over binary protocols such as VNC and RDP and translates them into Guacamole's text-based protocol, which a web client can process easily.
Is guacamole-server free to use? What license does it have?
guacamole-server is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is guacamole-server still maintained?
Actively maintained. The last commit to guacamole-server was on Oct 17, 2026.
What can I use guacamole-server for?
Running a clustered or self-hosted browser-based remote desktop gateway. Providing browser access to internal SSH, VNC or RDP hosts without client software. Building or packaging the guacd backend for a Guacamole web deployment.
How do I install guacamole-server?
Install the required dependencies (Cairo, libjpeg-turbo, libpng, OSSP UUID) and the protocol libraries you need Run configure: ./configure Build with make: make Install as root: make install Run guacd directly: guacd
Where can I get guacamole-server?
The source code and installation instructions are on GitHub: https://github.com/apache/guacamole-server

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects