[New Addon] Access machines in your homenet with Apache Guacamole, Ingress Support!

bleakvin · July 6, 2020, 12:59pm

Hi everyone,

I cobbled together this addon which some of you might find usefull.

Guacamole is a HTML5 webclient for RDP, VNC and SSH enabling you to remote into PCs or VMs with nothing but a webbrowser.

In the past i used a self contained docker image from oznu (https://github.com/oznu/docker-guacamole). Today i decided to try integrating that into Homeassistant. My Addon is basicly just that docker image with some very minor modifications to make it into a Homeassitant addon with Ingress support.

Since this is my very first attempt an making an addon for Homeassistant the integration is quiet basic. Namely no support for authentication through Homeassiant or something like that. ~~and the only working platform is x64. (sorry raspberry pi users)~~

When first installing this addon Homeassiant might give an error message that installation failed. Just give it a few minutes it will pop up eventually. (I think this might be due to the size of the container)

The default login is “guacadmin” for both username and password.

dave122 · July 7, 2020, 2:33am

This is a very handy addon, Thank you!

I have tested it with SSH and it works great.

jonrub11 · July 7, 2020, 9:00am

Nice, is it possible to see what version of Guacamole is installed in the addon?

bleakvin · July 7, 2020, 11:09am

On the Guacamole login screen in the bottom right corner.
Right now its 1.2.0

bleakvin · July 10, 2020, 12:23pm

I changed the url in the first post so that the addon has its own repository.
I also added support for installing it on a Raspberry Pi. Keep in mind that building the addon on a Raspberry Pi can take quiet a while.(close to 20 minutes on a PI 3B)

Vlad · July 10, 2020, 12:33pm

Link on addon broken:
Visit Guacamole page for details.
Instead pointing to Apache Guacamole it’s point to https://xxxxx.duckdns.org/null

KingRichard · October 13, 2020, 1:54pm

heem how do I install it?

Burningstone · October 13, 2020, 2:23pm

Follow the instructions in the docs here to a non-official add-ons. Then put https://github.com/bleakvin/hass-guacamole of the repo as the URL to add.

d-two · October 22, 2020, 10:51pm

I have tested your Addon on the RPi 4 (8GB) with ARCH “aarch64” and it is not working, because it is only amd64 compatible…

I forked your Repo and fixed that
Now it is compatible with amd64, armhf, aarch64 and armv7…

I have only tested the aarch64 and this worked like a charm …
The other arch like armhf and armv7 need to be tested

Here is my Addon Repo:

The-May · November 11, 2020, 1:53pm

This works like a charm.
Currently only ingress works…any way to expose this on a port?

d-two · November 11, 2020, 4:23pm

Under setting you can set a port to expose…

The-May · November 11, 2020, 10:20pm

I used the „original“ addon from OP.

Your „fork“ did the trick. Cheers.

Thanks alot for creating this!

liminal · March 31, 2021, 10:31pm

Is there something like this I can instal on HASS OS?

Thanks

bleakvin · May 27, 2021, 9:37am

I absolutely forgot that I had put this on here
I just updated the add-on to Guacamole 1.3.0 and implemented/ copied the chages that @d-two made to make it compatible with more platforms.
I also made a change request to the add-on repository of @d-two to update it to 1.3.0 as well.

Mincka · July 26, 2021, 10:05am

Sadly, I am unable to use it on my Odroid N2+ (Official HA Blue version).
Once the add-on is started, right after login, I get:

ERROR

An error has occurred and this action cannot be completed. If the problem persists, please notify your system administrator or check your system logs.

And in the add-on logs:

11:53:29.854 [http-nio-8080-exec-3] INFO  o.a.g.r.auth.AuthenticationService - User "guacadmin" successfully authenticated from [127.0.0.1, 172.30.32.1, 172.30.32.2].
11:53:30.296 [http-nio-8080-exec-1] ERROR o.a.g.rest.RESTExceptionMapper - An internal error occurred, but did not contain an error message. Enable debug-level logging for details.
11:53:30.302 [http-nio-8080-exec-10] ERROR o.a.g.rest.RESTExceptionMapper - An internal error occurred, but did not contain an error message. Enable debug-level logging for details.

Does anybody know how to solve it? Thanks.

SilverBeard · July 28, 2021, 11:26am

Hello,

I’ve got the exact same problem with Home Assistant installed in a VM.

Thanks for your help

GuyD · July 29, 2021, 4:26am

Same issue here. Any solutions?

bleakvin · July 29, 2021, 1:07pm

I can confirm this issue.
Since no changes to the Addon have been made, I can only guess that something in the way Homeassistant interfaces with the addon must have changed. I will take a look at it but cant really promise a solution.

hbradlow · August 10, 2021, 6:21am

Me too - exactly the same error in HassOS in a virtualbox VM.

gislis2 · August 26, 2021, 6:24pm

Getting this error on a HomeAssistant OS after entering the credentials and logging in
When I enable external access via port (8080) I can login directly via that port

18:17:00.239 [http-nio-8080-exec-4] ERROR o.a.g.rest.RESTExceptionMapper - An internal error occurred, but did not contain an error message. Enable debug-level logging for details.

A longshot - might be related to the change in 2021.7 to the frontend now supporting password managers. IIRC it was a security requirement needed for it - might have caused Guac to panik