Skip to content
Hoody Documentation
Download Page (.md)

Workspaces

Section titled “Workspaces”

You don’t install an operating system anymore. You open a URL.

Traditional desktops are trapped on a single machine. Remote desktops require VPN tunnels, VNC viewers, specialized clients. Hoody Workspaces is none of that. It’s a full operating system running in a browser tab — drag-and-drop layouts, multi-container views, every Kit service embedded as a panel. Open it from any device, anywhere.

Access Your Workspace

Section titled “Access Your Workspace”

Workspaces runs at a single URL:

https://app.hoody.icu

Log in with your Hoody account. All your projects, containers, and services appear instantly.

What You Can Do

Section titled “What You Can Do”
  • Unified Dashboard — See all containers, projects, and servers in one place
  • Drag-and-Drop Layouts — Arrange terminal, display, files, and code panels however you want
  • Multi-Container Views — Embed services from different containers side-by-side in one workspace
  • Shareable URLs — Share your entire workspace layout with a URL
  • Any Device — Desktop, tablet, phone — if it has a browser, it runs Workspaces
  • Service Quick-Launch — Open any Kit service (terminal, display, files, SQLite, code) with one click
  • Project Switching — Jump between projects and containers instantly

The Workspace Model

Section titled “The Workspace Model”

Every panel in a workspace is just a URL. Terminal? URL. Display? URL. File manager? URL. Code editor? URL. The workspace arranges them:

┌─────────────────────────────────────────────┐
│ Workspace: "My Dev Environment"             │
├──────────────────┬──────────────────────────┤
│ Terminal-1       │ Display-1                │
│ (shell access)   │ (GUI desktop)            │
├──────────────────┼──────────────────────────┤
│ Files            │ Code-1                   │
│ (file manager)   │ (VS Code)               │
└──────────────────┴──────────────────────────┘

Each panel maps to a Kit service URL:

Terminal:  https://PROJECT-CONTAINER-terminal-1.SERVER.containers.hoody.icu
Display:   https://PROJECT-CONTAINER-display-1.SERVER.containers.hoody.icu
Files:     https://PROJECT-CONTAINER-files-1.SERVER.containers.hoody.icu
Code:      https://PROJECT-CONTAINER-code-1.SERVER.containers.hoody.icu

The workspace saves the layout. Close the tab, reopen it — everything is exactly where you left it.

Key Concepts

Section titled “Key Concepts”

Panels

Section titled “Panels”

Each panel embeds a Kit service URL. Add panels for:

  • Terminals — any instance: terminal-1, terminal-2, etc.
  • Displays — remote desktop for any display instance
  • Files — file manager
  • SQLite — database UI
  • Code — VS Code editor
  • Browser — browser automation view
  • Any custom URL — embed anything with a URL

Layouts

Section titled “Layouts”

Arrange panels in rows, columns, and grids. Resize by dragging borders. Save layouts to switch between different working modes — a development layout, a monitoring layout, a presentation layout.

Multi-Container

Section titled “Multi-Container”

A single workspace can embed services from different containers. Monitor multiple environments, compare outputs, or manage a distributed system from one screen. Each panel points to a different container’s service URL — the workspace doesn’t care which container it’s talking to.

Common Patterns

Section titled “Common Patterns”

Development Workspace

Section titled “Development Workspace”

Terminal + Code + Display for full-stack development with live GUI preview. Write code in one panel, run it in another, see the output in a third.

Monitoring Dashboard

Section titled “Monitoring Dashboard”

Multiple terminals showing logs from different containers, plus a browser panel for status pages. One screen, full visibility across your infrastructure.

Presentation Mode

Section titled “Presentation Mode”

Share a workspace URL with a client to give them a live view of your infrastructure — without giving direct access. They see what you see. Nothing more.

What’s Next

Section titled “What’s Next”
The Hoody Kit All 18 HTTP services running in every container
Terminals Shell commands via HTTP — no SSH required
Displays Remote desktop via HTTP — GUI applications in your browser
Projects & Containers Understanding the resource model behind every workspace panel

Your desktop is a URL now. Open it from any device. Arrange it however you want. Share it with anyone. No VNC. No RDP. No VPN. Just a browser tab.