noVNC WebSocket Proxy

A lightweight Docker image that provides a web-based VNC client using noVNC and websockify. Connect to any VNC server through your browser without installing a VNC client.

This image runs a websockify proxy that bridges WebSocket connections from browsers to VNC servers. It includes the noVNC HTML5 VNC client, allowing you to access remote desktops directly from any modern web browser.

docker run -d --name novnc -p 6080:6080 -e VNCSERVER=your-vnc-host -e VNCPORT=5901 cuteminded/novnc:latest

Then open your browser and navigate to: https://localhost:6080

docker run -d --name novnc --network host -e VNCSERVER=127.0.0.1 -e VNCPORT=5900 cuteminded/novnc:latest

docker run -d --name novnc -p 6080:6080 -e VNCSERVER=192.168.1.100 -e VNCPORT=5901 cuteminded/novnc:latest

version: '3.8'
services:
  desktop:
    image: your-vnc-desktop-image
    expose:
      - "5901"

  novnc:
    image: cuteminded/novnc:latest
    ports:
      - "6080:6080"
    environment:
      VNCSERVER: desktop
      VNCPORT: 5901
    depends_on:
      - desktop

# Create a network
docker network create vnc-network

# Run your VNC server
docker run -d --name vnc-desktop --network vnc-network your-vnc-image

# Run noVNC proxy
docker run -d --name novnc --network vnc-network -p 6080:6080 -e VNCSERVER=vnc-desktop -e VNCPORT=5901 cuteminded/novnc:latest

• HTML5 VNC client accessible from any modern browser
• Secure WebSocket connections with SSL/TLS
• Lightweight image based on Ubuntu
• Multi-architecture support (amd64, arm64)
• No client-side VNC software required

• linux/amd64
• linux/arm64

This project is provided as-is for development and educational purposes.