# Webtop — Full Linux Desktop in Your Browser via Docker

> A containerized Linux desktop environment accessible through any web browser, supporting Ubuntu, Alpine, Arch, and Fedora with popular desktop environments.

## Install

Save as a script file and run:

# Webtop — Full Linux Desktop in Your Browser via Docker

## Quick Use
```bash
docker run -d --name=webtop 
  -p 3000:3000 
  -v /path/to/data:/config 
  lscr.io/linuxserver/webtop:latest
# Open http://localhost:3000 in your browser
```

## 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

---
Source: https://tokrepo.com/en/workflows/asset-e28756d2
Author: Script Depot