https://github.com/kenryus/docker-guacamole-re
A self-contained guacamole docker container for x64 and ARM. Remotely connect over SSH, RDP or VNC using HTML5. Revived from original @oznu's docker-guacamole with latest softwares.
https://github.com/kenryus/docker-guacamole-re
apache-guacamole client container docker docker-file forked-repo guacamole rdp rdp-client remote-access-tool remote-control remote-desktop server ssh ssh-client telnet vnc vnc-client
Last synced: about 2 months ago
JSON representation
A self-contained guacamole docker container for x64 and ARM. Remotely connect over SSH, RDP or VNC using HTML5. Revived from original @oznu's docker-guacamole with latest softwares.
- Host: GitHub
- URL: https://github.com/kenryus/docker-guacamole-re
- Owner: kenryuS
- License: gpl-3.0
- Created: 2023-07-28T02:20:08.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-06-21T14:43:33.000Z (over 1 year ago)
- Last Synced: 2025-02-24T13:18:22.169Z (8 months ago)
- Topics: apache-guacamole, client, container, docker, docker-file, forked-repo, guacamole, rdp, rdp-client, remote-access-tool, remote-control, remote-desktop, server, ssh, ssh-client, telnet, vnc, vnc-client
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/kenryus/docker-guacamole
- Size: 73.2 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
**This project is the fork of [oznu/docker-guacamole](https://github.com/oznu/docker-guacamole) with latest softwares.**
# Docker Guacamole
A Docker Container for [Apache Guacamole](https://guacamole.apache.org/), a client-less remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH over HTML5.
This image will run on most platforms that support Docker including Docker for Mac, Docker for Windows, Synology DSM and Raspberry Pi 3 boards.
[](http://www.youtube.com/watch?v=esgaHNRxdhY "Video Title")
This container runs the guacamole web client, the guacd server and a postgres database.
## Usage
```shell
docker run \
-p 8080:8080 \
-v :/config \
kenryus/docker-guacamole
```
## Raspberry Pi(32-bit) / armhf
This image will also allow you to run [Apache Guacamole](https://guacamole.apache.org/) on a Raspberry Pi or other Docker-enabled ARMv5/6/7/8 devices by using the `armhf` tag.
```shell
docker run \
-p 8080:8080 \
-v :/config \
kenryus/docker-guacamole:armhf
```
### Raspberry Pi(64-bit) / arm64(aarch64)
This image varient is for 64 bit arm. You can use this with `arm64` tag.
```
docker run \
-p 8080:8080 \
-v :/config \
kenryus/docker-guacamole:arm64
```
## Parameters
The parameters are split into two halves, separated by a colon, the left hand side representing the host and the right the container side.
* `-p 8080:8080` - Binds the service to port 8080 on the Docker host, **required**
* `-v /config` - The config and database location, **required**
* `-e EXTENSIONS` - See below for details.
## Enabling Extensions
Extensions can be enabled using the `-e EXTENSIONS` variable. Multiple extensions can be enabled using a comma separated list without spaces.
For example:
```shell
docker run \
-p 8080:8080 \
-v :/config \
-e "EXTENSIONS=auth-ldap,auth-duo"
kenryus/docker-guacamole
```
Currently the available extensions are:
* auth-ldap - [LDAP Authentication](https://guacamole.apache.org/doc/gug/ldap-auth.html)
* auth-duo - [Duo two-factor authentication](https://guacamole.apache.org/doc/gug/duo-auth.html)
* auth-header - [HTTP header authentication](https://guacamole.apache.org/doc/gug/header-auth.html)
* auth-cas - [CAS Authentication](https://guacamole.apache.org/doc/gug/cas-auth.html)
* auth-openid - [OpenID Connect authentication](https://guacamole.apache.org/doc/gug/openid-auth.html)
* auth-totp - [TOTP two-factor authentication](https://guacamole.apache.org/doc/gug/totp-auth.html)
* auth-quickconnect - [Ad-hoc connections extension](https://guacamole.apache.org/doc/gug/adhoc-connections.html)
You should only enable the extensions you require, if an extensions is not configured correctly in the `guacamole.properties` file it may prevent the system from loading. See the [official documentation](https://guacamole.apache.org/doc/gug/) for more details.
## Default User
The default username is `guacadmin` with password `guacadmin`.
## Windows-based Docker Hosts
Mapped volumes behave differently when running Docker for Windows and you may encounter some issues with PostgreSQL file system permissions. To avoid these issues, and still retain your config between container upgrades and recreation, you can use the local volume driver, as shown in the `docker-compose.yml` example below. When using this setup be careful to gracefully stop the container or data may be lost.
```yml
version: "3"
services:
guacamole:
image: kenryus/docker-guacamole
container_name: guacamole
volumes:
- postgres:/config
ports:
- 8080:8080
volumes:
postgres:
driver: local
```
## License
Copyright (C) 2017-2020 oznu
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the [GNU General Public License](./LICENSE) for more details.