/docker-novnc

noVNC Display Container for Docker

Primary LanguageDockerfileMIT LicenseMIT

noVNC Display Container

This image is intended to be used for displaying X11 applications from other containers in a browser. A stand-alone demo as well as a Version 2 composition.

Image Contents

  • Xvfb - X11 in a virtual framebuffer
  • x11vnc - A VNC server that scrapes the above X11 server
  • noNVC - A HTML5 canvas vnc viewer
  • Fluxbox - a small window manager
  • xterm - to demo that it works
  • supervisord - to keep it all running

Usage

Variables

You can specify the following variables:

  • DISPLAY_WIDTH=<width> (1024)
  • DISPLAY_HEIGHT=<height> (768)
  • RUN_XTERM={yes|no} (yes)
  • RUN_FLUXBOX={yes|no} (yes)

Stand-alone Demo

Run:

$ docker run --rm -it -p 8080:8080 ghcr.io/opn-ooo/docker-novnc

Open a browser and see the xterm demo at http://<server>:8080/vnc.html

Usage in Docker Compose

version: '2'
services:
  x11:
    image: ghcr.io/opn-ooo/docker-novnc
    environment:
      # Adjust to your screen size
      - DISPLAY_WIDTH=1600
      - DISPLAY_HEIGHT=968
      - RUN_XTERM=no
    ports:
      - "8080:8080"

On DockerHub / GitHub

Thanks

This is based on theasp/docker-novnc.