> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/aerial/aodt/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/aerial/aodt/_mcp/server.

# Viewer Installation

The AODT viewer is a web application for visualizing simulation data, entities, and ray paths on a 3D geospatial map. It can run on any machine with a browser as long as it has network access to the simulation database.

## Prerequisites

* **Node.js**: Vite 7 requires **Node.js 20.19+ or 22.12+**. This repo is tested with **Node.js 24+** and **npm 11+**.
* A modern web browser with WebGL 2.0 support

### Installing Node.js

**macOS / Linux (recommended — nvm):**

```bash
nvm install 24
nvm use 24

node -v
npm -v
```

**Windows:** Download the LTS installer from [nodejs.org](https://nodejs.org/en/download), run it, then verify with `node -v` and `npm -v`.

On Windows you can also use [nvm-windows](https://github.com/coreybutler/nvm-windows) or another version manager.

## Installation

From the repository root:

```bash
cd viewer
npm install
npm run dev
```

The application is available at `http://localhost:5173`. If running on a remote server, access it via the remote server's IP address: `http://<ip>:5173`.

### If `npm install` fails

A failed install is often caused by an outdated Node.js version. Check `node -v` and upgrade if it is below Vite 7's minimum. Then run a clean install:

```bash
rm -rf node_modules package-lock.json
npm install
```

## Connect to simulation data

After starting the viewer, open **Settings** in the right sidebar and configure the Iceberg catalog and S3/MinIO endpoint to point at the worker's database. See the [UI](/ui) section for viewer workflows.

## Production build

```bash
npm run build
npm run start
```