docker-novnc

noVNC in Docker.

GitHub | GitHub Container Registry | Docker Hub

Features

• Easy to connect. Open browser to connect to display, powered by TigerVNC + noVNC.
• Extensible. Use baseimage-docker as base image, with built-in runit.
• Lightweight. Use Openbox as WM, no SM/DE.
• Multi-Architecture. Supports amd64, arm64, armv7 and riscv64.

Usage

Try online

Start using Docker

docker run --rm -it --security-opt seccomp=unconfined -p 6080:80 -p 5901 -e VNC_PASSWD=password ifrstr/novnc

Start using Docker Compose

docker compose up

Start using Docker Swarm

docker stack deploy --compose-file docker-compose.yml novnc

Connect using browser

Navigate to http://localhost:6080 and login using password.

Connect using VNC Viewer

vncviewer :1 # Connect to 127.0.0.1:5901

Troubleshooting

Start bash with services:

docker run --rm -it -p 6080:80 -p 5901 -e VNC_PASSWD=password ifrstr/novnc /sbin/my_init -- bash -l

Start bash without services:

docker run --rm -it -p 6080:80 -p 5901 -e VNC_PASSWD=password ifrstr/novnc bash

Building

Create a builder:

docker buildx create --name container --driver=docker-container

Build image:

BUILD_DOCKER_BUILDER=container ./build.sh

Security

This image is NOT SECURE because VNC is not a secure protocol. DO NOT use this image directly over the Internet. Wrap the traffic in tunnel.

LICENSE

MIT