Overview

Mesh Storage is the home for your data inside Alloy. Drop in MCAP recordings from the web, let your devices upload automatically, then browse, replay, or query everything from the same page — no separate tooling, no manual conversion step.

What is Mesh Storage?

Mesh Storage is a managed data lake for your organization. Files land in object storage, get indexed into queryable tables, and become available everywhere in Alloy — Replay, SQL Workbench, and any Iceberg-compatible client like DuckDB, Spark, or Trino.

You'll see two top-level folders when you first open it:

• uploads/ — files you (or a teammate) drag into the web uploader
• devices/ — files uploaded automatically by your registered devices, organized by device

Both end up in the same data lake, queryable side by side.

A tour of the page

The Mesh Storage page has two parts: an action bar at the top and a file browser below.

The action bar exposes everything you can do at the org level:

• Upload — drop MCAP files in from your browser
• Device Setup — get the credentials and config snippets you need to connect a new device
• SQL Workbench — open the in-app query editor against your data lake
• Connect — generate an API key for external tools (DuckDB, Spark, Trino, Jupyter)

The file browser shows what's in the data lake — name, size, last modified, processing status, and a row menu for actions like Replay, Inspect, or Delete.

How a file moves through Mesh Storage

Whether you upload from the web or a device pushes it up, every file goes through the same lifecycle:

1. Queued — the file has landed in object storage and is waiting to be processed
2. Processing — Alloy is parsing the MCAP and building queryable tables
3. Ready — the file is queryable in SQL Workbench and external Iceberg clients
4. Failed — something went wrong; check the row for the error

Replay and Inspect work as soon as the file lands — you don't have to wait for processing to finish to scrub through a recording.

Next steps

• Getting data in — web uploads, Docker, or binary track-folder
• Managing your fleet — key rotation, recording config, redaction
• Exploring your data — the file browser, SQL Workbench, external clients
• Troubleshooting & FAQ — common questions and fixes