noVNC Display Container

This Docker container starts an X server with fluxbox, makes it accessible via noVNC, and then runs the command provided to it.

The container is based on debian:bullseye.

Usage (CLI)

docker run --rm -it -p 8080:8080 <imagename>

Then, open http://localhost:8080/.

To run a program, append it to the end of the command:

docker run --rm -it -p 8080:8080 <imagename> xterm

When run this way, the container will exit once the program you specified exits.

OR

ad your own configuration to supervisord config directory.

Supervisord Documentation

/app/conf.d/

Usage (As Dockerfile FROM base)

You can also use this container as a base image in a Dockerfile. Set up your Dockerfile as normal, then use CMD to specify what to run in the container (if anything). The following example installs wine, downloads the BGB Game Boy emulator, and sets it as the startup command for the container:

FROM <imagename>

# Install wine
RUN dpkg --add-architecture i386 && \
  apt-get update && \
  apt-get install -y wine wine32 unzip

# Download and unzip bgb
WORKDIR /root
RUN wget https://bgb.bircd.org/bgb.zip && \
  unzip bgb.zip

# Set bgb as the program to run when the container starts
CMD wine /root/bgb.exe

Architecture

This container is built using the following software:

• Fluxbox - the window manager for the X session
• noVNC - browser-based VNC client used to expose the X session to the host
• TigerVNC - the X server and VNC server used
• Supervisor - to start Fluxbox, noVNC, and TigerVNC

Credits

This container is based heavily on theasp/docker-novnc and suchipi/docker-novnc.

License

MIT