DEPRECATION NOTICE¶

This image is deprecated. We will not offer support for this image and it will not be updated.

Contact information:¶

Type	Address/Details
Discord	Discord
IRC	freenode at `#linuxserver.io` more information at:- IRC
Forum	LinuxServer.io forum

linuxserver/docker-baseimage-guacgui ¶

A custom graphical base image built with: * Ubuntu cloud image * S6 overlay * xrdp * xorgxrdp * openbox * guacamole

Supported Architectures¶

Our images support multiple architectures such as x86-64, arm64 and armhf. We utilise the docker manifest for multi-platform awareness. More information is available from docker here and our announcement here.

Simply pulling linuxserver/docker-baseimage-guacgui should retrieve the correct image for your arch, but you can also pull specific arch images via tags.

The architectures supported by this image are:

Architecture	Tag
x86-64	amd64-latest
arm64	arm64v8-latest
armhf	arm32v7-latest

Usage¶

Here are some example snippets to help you get started creating a container.

docker¶

docker create \  --name=docker-baseimage-guacgui \  -e PUID=1000 \  -e PGID=1000 \  -e TZ=Europe/London \  -e APPNAME=xclock \  -e GUAC_USER=abc `#optional` \  -e GUAC_PASS=900150983cd24fb0d6963f7d28e17f72 `#optional` \  -e GUAC_KEYBOARD_LAYOUT=de-de-qwertz `#optional` \  -p 8080:8080 \  -p 3389:3389 \  -v </path/to/appdata>:/config \  --restart unless-stopped \  linuxserver/docker-baseimage-guacgui

docker-compose¶

Compatible with docker-compose v2 schemas.

--- version: "2" services:  docker-baseimage-guacgui:  image: linuxserver/docker-baseimage-guacgui  container_name: docker-baseimage-guacgui  environment:  - PUID=1000  - PGID=1000  - TZ=Europe/London  - APPNAME=xclock  - GUAC_USER=abc #optional  - GUAC_PASS=900150983cd24fb0d6963f7d28e17f72 #optional  - GUAC_KEYBOARD_LAYOUT=de-de-qwertz #optional  volumes:  - </path/to/appdata>:/config  ports:  - 8080:8080  - 3389:3389  restart: unless-stopped

Parameters¶

Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container.

Parameter	Function
`-p 8080`	Allows HTTP access to the internal X server.
`-p 3389`	Allows RDP access to the internal X server.
`-e PUID=1000`	for UserID - see below for explanation
`-e PGID=1000`	for GroupID - see below for explanation
`-e TZ=Europe/London`	Specify a timezone to use EG Europe/London
`-e APPNAME=xclock`	Specify the graphical application name shown on RDP access.
`-e GUAC_USER=abc`	Specify the username for guacamole's web interface.
`-e GUAC_PASS=900150983cd24fb0d6963f7d28e17f72`	Specify the password's md5 hash for guacamole's web interface.
`-e GUAC_KEYBOARD_LAYOUT=de-de-qwertz`	Specify the used keyboard layout for the RDP session used by the gucamole client. Possible values are "en-us-qwerty" (default), de-de-qwertz (German keyboard (qwertz)), fr-fr-azerty (French keyboard (azerty)), fr-ch-qwertz (Swiss French keyboard (qwertz)), it-it-qwerty (Italian keyboard), ja-jp-qwerty (Japanese keyboard) and sv-se-qwerty (Swedish keyboard).
`-v /config`	Contains X user's home directory contents.

Application Setup¶

This is a baseimage meant to be used as base for graphical applications. Please refer to the example folder for usage.
If GUAC_USER and GUAC_PASS are not set, there is no authentication. Passwords can be generated via the following:

echo -n password | openssl md5

printf '%s' password | md5sum

Please beware this image is not hardened for internet usage. Use a reverse ssl proxy to increase security.

The following line is only in this repo for loop testing: - { date: "01.01.50:", desc: "I am the release message for this internal repo." }