Skip to content

Latest commit

 

History

History
86 lines (55 loc) · 2.15 KB

README.md

File metadata and controls

86 lines (55 loc) · 2.15 KB
Raw

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

Try in PWD

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