ifrstr/novnc repository overview

⁠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⁠.
• Lightweight. Use baseimage-docker⁠ as base image.
• Minimal desktop environment. 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 -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⁠