# Guacamole

Guacamole is a self-hosted other app. Apache Guacamole is a clientless remote desktop gateway that gives you access to VNC, RDP, SSH, and Telnet sessions from any modern web browser, without installing plugins or client software. It is open source and self-hosted, installable on Docker Hub, Unraid and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/1897/guacamole

## Description

Apache Guacamole is a clientless remote desktop gateway that gives you access to VNC, RDP, SSH, and Telnet sessions from any modern web browser, without installing plugins or client software. This Docker image bundles a built-in MariaDB database for authentication and configuration storage, and also supports external MySQL, MariaDB, PostgreSQL, or SQL Server databases plus SSO providers such as LDAP, SAML, TOTP, CAS, and OpenID. It is aimed at homelab and self-hosting users who need to reach servers and desktops from anywhere through a single web interface.

## Platform availability

Available on 4 of 10 platforms: Unraid, ZimaOS, Helm, Any server.

## Health score

48/100 (Fair), based on 4 of 4 factors.
- Maintained: 75 (last commit 49 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 65 (4 install platforms, install notes, Docker image)
- Light to run: 10 (8 GB minimum RAM)

## Links

- Docker Hub: https://hub.docker.com/r/cleao/guacamole
- Official website: https://guacamole.apache.org
- GitHub: https://github.com/cleao01/UnraidDockerGuacamole
- Unraid: https://ca.unraid.net/apps/guacamole-0ad3yt200gxco2?q=Guacamole
- Documentation: https://guacamole.apache.org/doc/gug/
- Kubernetes (Helm): https://artifacthub.io/packages/helm/beryju-org/guacamole

## Common questions

### How can I import many saved RDP, SSH, or VNC connections at once?

Use a JSON import file that includes each target host, login details, and the users or groups allowed to use the connection. Keep the file private because it can contain passwords, and wrong groups or users can stop people from connecting.

### How do I start a one-off SSH connection without creating a saved connection?

Enter a full URI such as ssh://linux1.example.com/ and Guacamole will prompt you for the username and password. Without the host part of the URI, Guacamole does not know which server to connect to.

### How do I encrypt traffic between Guacamole and guacd?

Set server_certificate and server_key in guacd.conf to the correct certificate and private key files. If those paths are missing or wrong, secure connections can fail or the setup may be easier for someone to snoop on.

### How should I embed Guacamole in another web page?

Rather than using an iframe, use Guacamole's JavaScript API, guacamole-common-js, to integrate Guacamole into your page directly. You can also build your own web application from Guacamole's core Java API if that would help.

### Should I immediately report connection problems as bugs?

Before assuming you found a bug, perform basic troubleshooting steps to confirm that Guacamole itself is the only factor affecting the issue. Guacamole is used by many others, so a fundamental problem is less likely to be a bug.

## Alternatives

- Boundary: HashiCorp Boundary Community Edition is an archived zero-trust access gateway that lets teams and homelab admins securely reach internal se…
- FreeRDP: FreeRDP is a free implementation of the Remote Desktop Protocol (RDP), released under the Apache license.
- HopToDesk: HopToDesk is a free, open source remote desktop application for Windows, macOS, Linux, FreeBSD, Android, iOS, Chrome OS and Raspberry Pi, p…
- LogMeIn Resolve: Endpoint management with remote control, IT management, monitoring, access, support, ticketing, and automation.
- MeshCentral: MeshCentral is a self-hosted, web-based platform for remotely monitoring, controlling, and managing computers and devices on a local networ…
- NoMachine: Access remote computers easily with enterprise-class speed and features supporting any content including audio and video.
- RealVNC: Secure, cost-effective remote access and support for your computer, from your desktop or mobile device.
- Remmina: Remmina is a cross-platform remote desktop client for system administrators and users who need to manage many remote computers through Remo…
- RustDesk: RustDesk is an open-source remote desktop and control platform that lets self-hosters securely access and manage devices from anywhere with…
- Screego: Screego is an open-source screen-sharing app for developers that lets you share your screen with multiple users in a browser using low-late…
- TeamViewer: Establish remote desktop access in seconds with instant control, secure data, VoIP and webcam integration, file transfer, and fast, easy co…
- TigerVNC: TigerVNC is an advanced VNC implementation.

---
Source: Our Local Host (https://ourlocalhost.com/app/1897/guacamole), the self-hosted and open-source app directory.
