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

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.

3 Likes

This is a very handy addon, Thank you!

I have tested it with SSH and it works great.

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

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

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)

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

heem how do I install it?

1 Like

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.

1 Like

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 :wink:
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 :crazy_face:

Here is my Addon Repo:

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

Under setting you can set a port to expose…

I used the „original“ addon from OP.

Your „fork“ did the trick. Cheers.

Thanks alot for creating this!

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

Thanks :slight_smile:

I absolutely forgot that I had put this on here :sweat_smile:
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.

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. :wink:

2 Likes

Hello,

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

Thanks for your help

Same issue here. Any solutions?

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.

2 Likes

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

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

1 Like