cuteminded/novnc repository overview

⁠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.

⁠Overview

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.

⁠Quick Start

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

⁠Environment Variables

⁠Ports

⁠Usage Examples

⁠Connect to a VNC Server on the Same Host

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

⁠Connect to a Remote VNC Server

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

⁠Docker Compose with VNC Desktop

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

⁠Using with Docker Networks

# 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

⁠Features

• 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

⁠Supported Architectures

• linux/amd64
• linux/arm64

⁠License

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