Webtop — Full Linux Desktop in Your Browser via Docker

Introduction

Webtop by LinuxServer.io delivers a full Linux desktop environment inside a Docker container, accessible via any modern web browser. It lets you run graphical Linux applications remotely without installing VNC clients or configuring X11 forwarding.

What Webtop Does

• Serves a complete Linux desktop through a browser-based KasmVNC session
• Supports Ubuntu, Alpine, Arch, and Fedora base images
• Offers XFCE, KDE, MATE, i3, IceWM, and Openbox desktop environments
• Persists user data and application state across container restarts
• Enables hardware-accelerated rendering with GPU passthrough support

Architecture Overview

Webtop combines a LinuxServer.io base image with KasmVNC, which streams the desktop to the browser over WebSocket. The container runs a lightweight init system (s6-overlay) that manages the display server, window manager, and auxiliary services. Network traffic is served over HTTPS when configured with a reverse proxy, and all user data is stored in a bind-mounted /config volume.

Self-Hosting & Configuration

• Pull the desired image tag (e.g., webtop:ubuntu-xfce or webtop:alpine-kde)
• Map port 3000 for HTTP access or 3001 for HTTPS
• Mount a persistent volume at /config for user home directory data
• Set PUID and PGID environment variables to match your host user
• Pass --device /dev/dri for GPU acceleration on supported hardware

Key Features

• Zero-client-install access from any device with a browser
• Multiple concurrent sessions on separate ports or via reverse proxy paths
• Application installation via the distro's native package manager
• Clipboard sharing between the browser and the Linux desktop
• Configurable resolution and frame rate to match network bandwidth

Comparison with Similar Tools

• Apache Guacamole — clientless remote desktop but requires separate VNC/RDP servers
• KasmVNC — the underlying VNC technology Webtop builds on, used standalone
• Neko — browser-based virtual desktop focused on shared watching sessions
• noVNC — lightweight VNC web client but lacks the full container orchestration
• Coder — cloud development environment focused on code editing, not full desktops

FAQ

Q: Which desktop environment should I choose? A: XFCE uses the least resources. KDE offers the richest experience. i3 is best for keyboard-driven workflows.

Q: Can I install custom software inside the container? A: Yes. Use apt, apk, or pacman depending on the base image. Installed packages persist if /config is mounted.

Q: How much RAM does Webtop need? A: The XFCE variant runs comfortably with 512 MB. KDE and full desktop environments benefit from 2 GB or more.

Q: Is Webtop suitable for production use? A: It works well for personal and small-team use. For enterprise remote desktops, consider Kasm Workspaces or Apache Guacamole.

Sources

• https://github.com/linuxserver/docker-webtop
• https://docs.linuxserver.io/images/docker-webtop