Mailing-List: contact user-help@guacamole.incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: user@guacamole.incubator.apache.org
From: Andy Pattrick <andy.pattrick@horiba.com>
To: "user@guacamole.incubator.apache.org" <user@guacamole.incubator.apache.org>
Subject: RE: Apply theme extension to docker container
Thread-Topic: Apply theme extension to docker container
Thread-Index: AQHSFN67s+oAQSEsgUah8Imd9OrkdaCMfE0AgAIv0BY=
Date: Wed, 28 Sep 2016 09:31:30 +0000
Message-ID: <0B640BC754C823498D4BFFC8F94A25F601BF4E84@SRHDC1.SRH.local>
References: <0B640BC754C823498D4BFFC8F94A25F601BB6898@SRHDC1.SRH.local>,<CALKeL-Oa5K71b+WEFhVsxfjTeajuYA6_JK4dMwN3rq3Y6EscbQ@mail.gmail.com>
In-Reply-To: <CALKeL-Oa5K71b+WEFhVsxfjTeajuYA6_JK4dMwN3rq3Y6EscbQ@mail.gmail.com>
Accept-Language: en-GB, en-US
Content-Language: en-GB
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
archived-at: Wed, 28 Sep 2016 09:31:48 -0000

Thanks for the detailed explanation Mike. I understand now. I'll try to giv=
e that a go when I have a moment.

Cheers Andy.

________________________________________
From: Mike Jumper [mike.jumper@guac-dev.org]
Sent: 27 September 2016 02:06
To: user@guacamole.incubator.apache.org
Subject: Re: Apply theme extension to docker container

On Thu, Sep 22, 2016 at 7:36 AM, Andy Pattrick <andy.pattrick@horiba.com> w=
rote:
> Hi,
>
> I'm trying to apply the example theme extension jar from this thread
> https://sourceforge.net/p/guacamole/discussion/1110834/thread/be2a6785/ t=
o
> my running guacamole docker container. This is to customise the logo and
> title etc as supported by https://glyptodon.org/jira/browse/GUAC-587
>
> I copy the example jar file to my container /root/.guacamole/extensions/
> using docker cp and I can see the file is there after the copy but nothin=
g
> changes when I reload the web page. I figured that the web server has to =
be
> restarted somehow to load up the new images and translations.
>
> If I stop and start the docker container then the jar file vanishes from =
the
> folder.
>
> I tried copying the jar file and then immediately doing a docker commit t=
o
> create my own customised image but again when I run this in a container t=
he
> jar file has vanished!
>
> Does anyone know what I'm doing wrong? Why is the extension jar file
> vanishing? How do I apply the example extension to my docker container?
>

The .jar file is vanishing because the startup script for the
Guacamole Docker container recreates GUACAMOLE_HOME every time the
container starts, auto-generating the configuration and copying in any
required extensions based on the environment variables set when the
container was created.

There are WIP changes which will allow you to define a base
GUACAMOLE_HOME which the Docker container will use as a template prior
to generating its own configuration. You can use that to provide your
own extension(s) or arbitrary config:

https://issues.apache.org/jira/browse/GUACAMOLE-100

Those changes will not be making their way to git master until the
release is finally out (we are under code freeze until then), but you
can give them a shot as-is by using branch containing the changes:

https://github.com/mike-jumper/incubator-guacamole-client/tree/docker-guaca=
mole-home

With the above, the "GUACAMOLE_HOME" environment variable can be used
to specify an arbitrary location to be copied into the real
GUACAMOLE_HOME just prior to auto-generating the configuration.
GUACAMOLE_HOME will still be wiped out each time the image starts, but
your custom GUACAMOLE_HOME will remain untouched and will still be
used as a basis. If you mount a local directory within the image and
specify that for GUACAMOLE_HOME, then external changes will be
reflected within the image whenever it is restarted, and things should
be pretty convenient.

- Mike=