Docker Guacamole for RPi 3 (ARM)

A Docker Container for Apache Guacamole, a client-less remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH over HTML5.

This image will run on Raspberry Pi 3 boards with Docker support.

This container runs the guacamole web client, the guacd server and a postgres database. This project is RPi specific fork of https://github.com/oznu/docker-guacamole

Usage

docker pull iiot/guacamole:arm32v7
docker run \
  -p 8080:8080 \
  -v </path/to/config>:/config \
  iiot/guacamole:arm32v7

Build

docker build --tag rpi/guacamole:1.0 docker-guacamole

Alternativly, you can build using provided Travis-CI script. You will need to add the following environment variables to your Travis-CI configuration: DOCKER_USERNAME, DOCKER_PASSWORD and REPO (your Docker repository).

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:

docker run \
  -p 8080:8080 \
  -v </path/to/config>:/config \
  -e "EXTENSIONS=auth-ldap,auth-duo" \
  iiot/guacamole:arm32v7

Currently the available extensions are:

• auth-ldap - LDAP Authentication
• auth-duo - Duo two-factor authentication
• auth-header - HTTP header authentication
• auth-cas - CAS Authentication
• auth-openid - OpenID Connect authentication
• auth-totp - TOTP two-factor authentication
• auth-quickconnect - Ad-hoc connections extension

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 for more details.

Default User

The default username is guacadmin with password guacadmin.

License

Copyright (C) 2017-2020

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 for more details.