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