A Docker Desktop Extension that allows you to connect to VNC servers running inside Docker containers or on remote hosts — directly from Docker Desktop.

• Overview
• Features
• What You Can Do
• Why Use This Extension
• Installation
  • Install from Docker Marketplace
  • Manual Installation
• Usage
  • Try the Example Container
  • Working with Sessions
    • Connect to a Docker Container
    • Run from a Docker Image
    • Connect to a Remote Host

This Docker Desktop Extension creates a temporary proxy container using noVNC, giving you browser-based access to any VNC server — whether it's inside another container or running on a remote host.

• Connect to Docker containers, images, or remote VNC servers
• Automatic Docker networking and cleanup
• Secure session management with persistent storage
• Includes pre-built environments:
  • Xfce
  • Cinnamon
  • MATE
  • KDE-Plasma
  • LXDE
  • LXQT
  • xTerm

Launch popular apps without installing anything on your host:

• Browsers (Firefox, Chromium)
• Editors (VS Code, LibreOffice)
• Tools (GIMP, PDF viewers)

And many more...

✔️ Ideal for isolated, disposable environments. Ideal for temporary, sandboxed tasks without cluttering your OS.

Spin up clean browser instances in seconds for testing login flows, UI layouts, or performance.

💡 Use multiple containers for parallel testing.

Try our ready-to-use Selenium testing example:

1. Navigate to the /examples/selenium directory

2. Follow the step-by-step guide in the README file to:

   • Set up a Selenium Chrome container
   • Run automated browser tests
   • Watch the tests execute in real-time

   🔍 Perfect for visual debugging of Selenium test suites

Open suspicious files in an isolated Linux environment.

🔒 Just close the container to dispose of everything.

Run GUI debuggers or desktop editors inside a container.

💻 Perfect for debugging GUI-based apps or editors (e.g. GDB GUI, VS Code Desktop) without leaving Docker.

Use GUI-reliant tools in headless pipelines.

🔁 Ideal for automated PDF/image generation or GUI testing.

Provide ready-to-use Linux desktops for workshops, demos, or internal labs.

🎓 Great for teaching Linux, Docker, or OSS tools.

• ✅ Zero Setup – Just launch from Docker Desktop
• 📦 Fully Containerized – Nothing installed on the host
• 🔒 Safe & Isolated – Perfect for testing risky files
• 🔧 Customizable – Add your own Dockerfiles and tools

👉 Click here to install via Docker Desktop Marketplace

docker extension install pgmystery/docker-extension-vnc:1.3.4

Click the "Try example container" button to launch a prebuilt Ubuntu VNC image with a desktop environment.

Sessions allow you to save and manage connection presets. Stored securely in a Docker volume via a backend container using SQLite.

To create a session:

1. Click the ➕ icon
2. Fill out the form
3. Save and click Connect

Supported connection types:

• Docker Container
• Docker Image
• Remote Host

1. Create a new session
2. Select Docker Container
3. Choose a running container or enter its name/ID
4. Set the internal VNC port
5. (Optional) Enter credentials
6. Save and connect

1. Enter a unique Session name.
2. Choose Docker Image as the connection type.
3. Select a VNC-enabled Docker Image from the Docker-Hub or locally (e.g. selenium/standalone-chrome-debug).
4. Select the image tag.
5. (Optional) Add Docker Run Options.
6. (Optional) Specify a custom Docker Run command with Args.
7. Specify the VNC-Server port.
8. Choose whether to remove the Container after disconnecting or keep it alive.
9. (Optional) Enter the credentials for the VNC connection if you want to store them.
10. Save and connect

1. Enter a unique Session name.
2. Choose Remote Host as the connection type.
3. Enter the IP-Address of the remote host.
4. Specify the VNC-Server port.
5. (Optional) Enter the credentials for the VNC connection if you want to store them.
6. Save and connect

Supports Linux, macOS, and Windows hosts.

• Docker Extension on Docker Hub
• Example Ubuntu VNC Image
• noVNC GitHub
• Proxy Container