linuxserver/docker-webtop

What is it?

Key features

• 01Multiple desktop flavors including XFCE, KDE, MATE, i3, and LXQt.
• 02Base images available for Alpine, Ubuntu, Debian, Fedora, and Arch.
• 03Desktop accessed through any modern web browser over HTTPS.
• 04Optional GPU acceleration for Intel, AMD, and Nvidia hardware.
• 05Clipboard sync, file transfer, audio, and gamepad support in the web client.
• 06Configurable user IDs, timezone, and a persistent config volume.

Use cases

• Running a disposable Linux desktop in a browser for testing or training.
• Accessing a full Linux environment from a machine without a local Linux install.
• Hosting a shared or multi-user desktop on a home or lab server.
• Trying different desktop environments without installing them on the host.

Quick start

1. 1

   Start a minimal test container with the docker run command

   docker run --rm -it --shm-size=1gb -p 3001:3001 lscr.io/linuxserver/webtop:latest bash
2. 2

   Open https://localhost:3001 in your browser and accept the self-signed certificate warning

Things to know

• !Exposes privileged host access and has no authentication by default, so it should not be exposed to the internet without protection.
• !The web interface gives passwordless sudo, so anyone who can reach it can gain root inside the container.
• !Nvidia GPU acceleration requires proprietary drivers and is not available on Alpine-based images.

In collections

Topics

FAQ

What is docker-webtop?

Docker images that run full Linux desktop environments (XFCE, KDE, MATE, i3, LXQt) in any modern web browser. Webtop is a set of Docker images from LinuxServer.io that package complete Linux desktop environments and stream them to a web browser. Each image is built on Alpine, Ubuntu, Debian, Fedora, or Arch, and is available in flavors including XFCE, KDE, MATE, i3, and LXQt, with tags for each combination.

Is docker-webtop free to use? What license does it have?

docker-webtop is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.

Is docker-webtop still maintained?

Actively maintained. The last commit to docker-webtop was on Oct 22, 2026.

What can I use docker-webtop for?

Running a disposable Linux desktop in a browser for testing or training. Accessing a full Linux environment from a machine without a local Linux install. Hosting a shared or multi-user desktop on a home or lab server. Trying different desktop environments without installing them on the host.

How do I install docker-webtop?

Start a minimal test container with the docker run command: docker run --rm -it --shm-size=1gb -p 3001:3001 lscr.io/linuxserver/webtop:latest bash Open https://localhost:3001 in your browser and accept the self-signed certificate warning

Where can I get docker-webtop?

The source code and installation instructions are on GitHub: https://github.com/linuxserver/docker-webtop