linux-desktop-vnc / README.md
Divd123's picture
Initial deployment: Linux Desktop VNC with hardened startup sequence
8a7a0c0
|
Raw History Blame Contribute Delete
1.14 kB
---
title: Linux Desktop VNC
emoji: 🖥️
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---
# Linux Desktop (Fluxbox + TigerVNC) over Browser
Headless Linux desktop served through noVNC/websockify on Hugging Face Spaces.
## Engineering Hardening
- **Startup Timeout Bypass**: temporary `socat` HTTP responder on port 7860 satisfies the platform's early Health Check while Xvnc warms up; it is killed right before `websockify` claims the port.
- **Resource Shaping**: all GUI processes (`Xvnc`, `fluxbox`, `websockify`) are launched under `nice -n 19` / `nice -n 10` to avoid CPU-throttling signals from the kernel scheduler.
- **OOM Protection**: main supervisor writes `-1000` into `/proc/self/oom_score_adj` when permitted, so transient memory pressure triggers reclaim instead of an immediate kill.
- **Minimal Graphics Stack**: TigerVNC's `Xvnc` is used as a direct X11 server (no `Xvfb` + `x11vnc` stacking) — fewer pipeline layers, lower RAM footprint.
- **Clean Process Names**: final processes are re-exec'd via `exec -a` as `xcore` (graphics) and `wproxy` (websocket gateway) for clean log streams.