chris102994/docker-base-image-gui

A minimal docker base image that provides a GUI for future apps that support long-term deployment.

chris102994/docker-base-image-gui

This is a docker base image that can be used as a baseline for future containers that will be utilized for long-term deployments.

CI

Images

Base Distribution	Tag	Size
Ubuntu Bionic (18)	ubuntu-18-latest
Alpine 3.10	alpine-3.10-latest
Debian Bullseye (11)	debian-11-latest

Outside Packages

• Built on my Base Image
  • x11vnc - An X11 VNC Server.
    • This is built with libvncserver to support websockets for noVNC.
  • xvfb - An X Virtual Framebuffer Display Server.
  • openbox - A lightweight window manager.
  • nginx - A high performance HTTP server and reverse Proxy.
  • xterm - The Standard terminal emulator for the X window system.
  • noVNC - A HTML5 VNC Client.

Docker

docker run \
	--name=base-image-gui \
  	-e VNC_PASSWORD=password `optional` \
	-p 5700:5700 \
	-v </path/to/appdata/config>:/config \
	--restart unless-stopped \
	christopher102994/docker-base-image-gui:alpine-3.10-latest

Parameters

Container specific parameters passed at runtime. The format is <external>:<internal> (e.g. -p 443:22 maps the container's port 22 to the host's port 443).

Parameter	Function
-e APP_NAME	The Name of the App. (Optional - Recommended)
-e VNC_PASSWORD	Password for the VNC session. (Optional)
-e DISPLAY_WIDTH	VNC Server's display width. (Optional)
-e DISPLAY_HEIGHT	VNC Server's displat height. (Optional)
-p 5700	The web encrypted UI port.
-e USERNAME	The Username you wish to run as. (Optional)
-e GROUPNAME	The Groupname you wish to run as. (Optional)
-e PUID	The UID you wish to run and save files as. (Optional)
-e PGID	The GID you wish to run and save files as. (Optional)
-v /config	All the config files for your app.

Adding Subsequent Apps

# Ensure the icon is correct for noVNC
cp /path/to/16x16icon /etc/noVNC/app/images/icons/novnc-16x16.png