Documentation GuidesCore prototype v1.0.0
Workstations, Services & Inspection
Dual-track provisioning, Deep Container Inspector, live WebSocket terminal, and two-tier storage.
Workstations, Services & Inspection
prototype provisions Linux desktop workstations and headless database containers with instant lifecycle control.
⚡ Dual-Track Provisioning
Choose between curated 1-click presets or fine-grained hardware and resource blueprints.
| Mode | Capability | Target Workloads |
|---|---|---|
| Quick Launch | 1-Click instant boot with calibrated memory and /dev/shm | Ubuntu XFCE/KDE, Debian KDE, PostgreSQL 16, Redis 7, MariaDB 11, Gitea |
| Custom Blueprint | Configurable CPU quotas, RAM limits, GPU nodes (/dev/dri), and OCI runtimes | Custom CUDA/AI sandboxes, microVMs, air-gapped workstations |
Curated Presets Matrix
| Preset | Image | Default Port | Recommended /dev/shm | Best For |
|---|---|---|---|---|
| Ubuntu XFCE | lscr.io/linuxserver/webtop:ubuntu-xfce | 3000 | 1024 MB | Daily software development, Python/Node.js (~250MB idle) |
| Ubuntu KDE | lscr.io/linuxserver/webtop:ubuntu-kde | 3001 | 2048 MB | Modern GUI, High-DPI scaling, Dolphin file manager |
| Debian KDE | lscr.io/linuxserver/webtop:debian-kde | 3002 | 2048 MB | Rock-solid Debian 12 stability, long-running batch tasks |
| PostgreSQL 16 | postgres:16-alpine | 5432 | 64 MB | Relational SQL database with auto-initialized development credentials |
| Redis 7 | redis:7-alpine | 6379 | 64 MB | In-memory key-value cache and pub/sub message broker |
🔍 Deep Container & Kernel Inspector
Click Inspect on any dashboard card to view kernel isolation metrics and edit container configurations live.
- Namespaces & Kernel: Inspect Linux IPC, PID, UTS, and Network namespace IDs alongside real-time cgroups v2 CPU and memory quotas.
- Security & Capabilities: View dropped capabilities (
CapDrop: ALL), permitted capabilities, and Seccomp filters. - Live Docker Compose v3.8 Editor: Edit synthesized YAML specifications directly in the browser and re-apply changes with one click.
- Snapshots & Rollback: Commit container writable layers to local timestamped images and rollback instantly if an experiment fails.
🖥️ Live Web Terminal & Telemetry
Access root shell consoles and streaming telemetry metrics directly inside the browser.
json
// SSE Telemetry Packet (GET /api/instances/{id}/stats)
{
"cpu_percent": 2.4,
"memory_usage_mb": 384.2,
"memory_percent": 9.38,
"network_rx_mb": 1.25,
"pids": 32
}
- Interactive Terminal: Connects via WebSockets (
/api/instances/{id}/terminal) with full ANSI colors and dynamic PTY resizing ({ "type": "resize", "cols": 120, "rows": 40 }). - Low-Overhead Telemetry: Server-Sent Events stream live resource gauges with
< 15MBdaemon memory footprint.
💾 Two-Tier Storage Architecture
User data is cleanly separated into dedicated Docker named volumes to prevent accidental data loss during container updates.
| Storage Tier | Mount Path | Purpose |
|---|---|---|
| Settings Partition | /config | Stores desktop shortcuts, browser cookies, and window manager configuration. |
| Workspace Partition | /config/workspace | Dedicated storage partition for source code and git repositories. |
| Host Bind Mounts | Custom | Direct host folder mapping with granular Read-Only (ro) or Read-Write (rw) flags. |