Skip to content


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 more information at:- IRC
Forum forum



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


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


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 \


Compatible with docker-compose v2 schemas.

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


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." }