Apache Guacamole is a clientless remote desktop gateway. It supports standard protocols like VNC, RDP, and SSH.
They call it clientless because no plugins or client software are required, it runs straight out of a browser.
Once it is up, running and configures, having all your logins at your fingertips is nice. It limits / removes memorizing IP addresses or setting up DNS re-directs. However, trying to get Guacamole running on a Raspberry PI has been a pain to say the least. Many of the videos I found have a single step install using Docker. However, many are old and to the oznu/guacamole image they use isn’t being maintained, over 3 years as of this posting.
I’ve tried other versions, on arm64 and x86 and only found one on x86 that worked well for me on a mini pc.
However, I found the version below being able to on aarch64 / arm64. The flcontainers/guacamole container works great on both the raspberry pi 4 (and probably the 5) and on Pimox, the pi version of Proxmox
The image location & readme: https://hub.docker.com/r/flcontainers/guacamole
To augment the documentation, here is my docker compose file that I built based on the readme:
services:
guacamole:
container_name: guacamole
image: flcontainers/guacamole
restart: always
volumes:
- '<path_to_config_here>:/config'
ports:
- 8080:8080/tcp
environment:
- /etc/localtime:/etc/localtime:ro
- TZ="America/Boise"
#extensions:
#- "auth-totp"Uncomment the extension if you want two-factor authentication. Look into the documentation for other version of two factor that are also available.
The admin account is guacadmin password guacadmin. Be sure to make your own account then delete the guacadmin account.