From 9cc483f63bbf99254d4caabc9dd293f746045c09 Mon Sep 17 00:00:00 2001
From: tiennm99 <tiennm99@outlook.com>
Date: Mon, 5 Oct 2026 09:54:03 +0700
Subject: [PATCH] feat(webtop): add Ubuntu XFCE web desktop

---
 README.md           |  1 +
 webtop/.env.example | 13 +++++++++++
 webtop/Dockerfile   |  4 ++++
 webtop/README.md    | 53 +++++++++++++++++++++++++++++++++++++++++++++
 webtop/compose.yml  | 19 ++++++++++++++++
 5 files changed, 90 insertions(+)
 create mode 100644 webtop/.env.example
 create mode 100644 webtop/Dockerfile
 create mode 100644 webtop/README.md
 create mode 100644 webtop/compose.yml

diff --git a/README.md b/README.md
index dbe161b..410b934 100644
--- a/README.md
+++ b/README.md
@@ -87,5 +87,6 @@ Each links to its own README for variables, ports, and storage.
 | [opencode](opencode/README.md) | opencode coding agent, served as a browser UI |
 | [paseo](paseo/README.md) | Paseo coding-agent daemon and web UI |
 | [traffmonetizer](traffmonetizer/README.md) | TraffMonetizer bandwidth-sharing client |
+| [webtop](webtop/README.md) | Ubuntu XFCE desktop in the browser |
 
 Licensed under Apache 2.0 — see [LICENSE](LICENSE).
diff --git a/webtop/.env.example b/webtop/.env.example
new file mode 100644
index 0000000..346be8f
--- /dev/null
+++ b/webtop/.env.example
@@ -0,0 +1,13 @@
+# Copy to .env and fill in. Never commit .env.
+#
+#   cp .env.example .env
+
+# Login for the web desktop, also the abc user's sudo password.
+# Generate one with: openssl rand -base64 24
+CUSTOM_USER=abc
+PASSWORD=
+
+TZ=Asia/Ho_Chi_Minh
+
+# Browser tab title.
+# TITLE=Webtop
diff --git a/webtop/Dockerfile b/webtop/Dockerfile
new file mode 100644
index 0000000..63f954a
--- /dev/null
+++ b/webtop/Dockerfile
@@ -0,0 +1,4 @@
+FROM lscr.io/linuxserver/webtop:ubuntu-xfce
+
+# Workspace directory owned by the abc user (PUID/PGID 1000).
+RUN mkdir -p /workspace && chown 1000:1000 /workspace
diff --git a/webtop/README.md b/webtop/README.md
new file mode 100644
index 0000000..0354688
--- /dev/null
+++ b/webtop/README.md
@@ -0,0 +1,53 @@
+# webtop
+
+[Webtop](https://docs.linuxserver.io/images/docker-webtop): a full Ubuntu
+XFCE desktop in the browser, from the LinuxServer image, streamed by Selkies.
+
+## Setup
+
+1. Set `PASSWORD`.
+2. Map the domain to port `3000` and deploy.
+3. Open the domain and log in with `CUSTOM_USER` / `PASSWORD`.
+
+Port `3000` serves plain HTTP and must sit behind the proxy, which adds HTTPS.
+The image's own HTTPS port `3001`, with a self-signed certificate, is unused.
+
+## Environment
+
+| Variable | Default | Purpose |
+| --- | --- | --- |
+| `CUSTOM_USER` / `PASSWORD` | `abc` / — | Login for the web desktop |
+| `TZ` | `Asia/Ho_Chi_Minh` | Desktop timezone |
+| `TITLE` | optional | Browser tab title |
+
+`PASSWORD` is required: without it the image serves the desktop, with a
+shell and `sudo`, to anyone who opens the domain.
+
+`PUID`/`PGID` are pinned to `1000` in `compose.yml`; the `Dockerfile` depends
+on that (see Storage).
+
+## Storage
+
+| Volume | Mount | Holds |
+| --- | --- | --- |
+| `webtop-config` | `/config` | Home directory: desktop settings, browser profiles, CLI logins, apps installed with `proot-apps` |
+| `webtop-workspace` | `/workspace` | Code and files you work on |
+
+The `Dockerfile` exists only to make `/workspace` writable. The image's init
+chowns `/config` to the `abc` user but not other paths, so a named volume on
+`/workspace` would come up `root:root`. Creating the directory in the image,
+owned by `1000:1000`, fixes that: Docker seeds an empty named volume from the
+image directory, ownership included.
+
+Software installed with `apt` lives in the container and is lost when it is
+recreated. Anything that must survive goes under `/config`, through
+`proot-apps` or a user-level install.
+
+## Resources
+
+`shm_size: 1gb` is upstream's recommendation for every desktop image; browsers
+and the video encoder run out of shared memory at Docker's 64 MB default.
+
+## Image
+
+`ubuntu-xfce` is LinuxServer's moving tag for the Ubuntu XFCE flavour.
diff --git a/webtop/compose.yml b/webtop/compose.yml
new file mode 100644
index 0000000..e6e5314
--- /dev/null
+++ b/webtop/compose.yml
@@ -0,0 +1,19 @@
+services:
+  webtop:
+    build: .
+    restart: unless-stopped
+    shm_size: 1gb
+    environment:
+      - CUSTOM_USER=${CUSTOM_USER:-abc}
+      - PASSWORD=${PASSWORD:?required}
+      - PUID=1000
+      - PGID=1000
+      - TZ=${TZ:-Asia/Ho_Chi_Minh}
+      # - TITLE=${TITLE:-Webtop}
+    volumes:
+      - webtop-config:/config
+      - webtop-workspace:/workspace
+
+volumes:
+  webtop-config:
+  webtop-workspace: