A containerized, self-hosted remote development workstation designed to turn a home gaming laptop into a centralized, headless development hub accessible from anywhere—without recurring cloud costs or host clutter.
Desk Harbor encapsulates an entire GNOME Flashback desktop and agentic coding development environment inside Docker, providing seamless browser-based remote desktop access, SSH terminal multiplexing, and direct NVIDIA CUDA hardware acceleration for AI workloads.
Architectural Overview #
- Containerized Desktop: Runs a lightweight GNOME Flashback session over TigerVNC and noVNC on port 6080, with dynamic viewport resizing and Tilix terminal emulator.
- CUDA & GPU Compute Passthrough: Configured via NVIDIA Container Toolkit to provide full GPU hardware acceleration for local AI inference and agentic workflows, while delegating X11 desktop display rendering to software to avoid display driver instability.
- Interactive Management TUI: A menu-driven Python/curses CLI (
./deskharbor) for lifecycle control, system diagnostics, configuration, and modular tool provisioning (Codex, Antigravity, Node, pyenv). - Dual Access Modes: Full graphical desktop accessible from any browser or native VNC client (Remmina), plus a dedicated OpenSSH server on port 20222 for lightweight mobile terminal access via Termux and tmux.
- Secure Homelab Integration: Bound exclusively to localhost and private LAN, secured externally via a homelab WireGuard VPN and on-demand Wake-on-LAN managed by a Telegram bot.