> ## Documentation Index
> Fetch the complete documentation index at: https://docs.generalrobotics.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Managed GRID Enterprise

> Connect to a pre-configured GRID cloud VM via VS Code

Managed GRID Enterprise is the fastest way to get started: the GRID team provisions a cloud VM for your organization with the platform pre-installed and configured. All licensing, resource configuration, and container services are ready—you just connect with VS Code and begin working.

***

## Prerequisites

You should have received from the GRID team:

* The **public IP address** (or DNS name) of the managed VM
* An **SSH private key** (e.g., `grid-enterprise.pem`)
* The **username** for the VM (typically `grid` or `ubuntu`)

<Note>If anything is missing, contact GRID support before proceeding.</Note>

***

## Setup

<Steps>
  <Step title="Prepare the SSH Key">
    Set restrictive permissions on your key file:

    ```bash theme={null}
    chmod 400 /path/to/grid-enterprise.pem
    ```

    Move it to your SSH directory:

    ```bash theme={null}
    mv /path/to/grid-enterprise.pem ~/.ssh/
    ```
  </Step>

  <Step title="Configure SSH">
    Add the host to `~/.ssh/config`:

    ```cfg theme={null}
    Host grid-managed
        HostName <MANAGED_VM_IP>
        User grid
        IdentityFile ~/.ssh/grid-enterprise.pem
    ```

    Replace `<MANAGED_VM_IP>` with your VM's IP address and adjust the username if different.
  </Step>

  <Step title="Install VS Code Extensions">
    Install [VS Code](https://code.visualstudio.com/) with the **Remote Development** extension pack (includes Remote-SSH and Dev Containers).
  </Step>

  <Step title="Connect to the VM">
    1. Open VS Code
    2. Press `F1` and run **Remote-SSH: Connect to Host…**
    3. Select `grid-managed`
    4. Wait for the remote window to open (green status bar)
  </Step>
</Steps>

***

## Using GRID

Once connected, open a terminal in VS Code (`Terminal > New Terminal`) and use the GRID CLI:

```bash theme={null}
grid
```

The environment is pre-configured with `GRID_DATA_DIR`, `license.json`, and `resource_config.json`. Start using GRID immediately:

```bash theme={null}
login @local
init airgen @local
session start demo
```

***

## Accessing Interfaces

Use the `open` command to launch interfaces. The CLI displays URLs for both local and VM access:

```bash theme={null}
open nb @local
open sim @local
open viz @local
```

<Note>
  When working remotely, use the VM IP addresses shown in the output. VS Code's built-in port forwarding (in the **PORTS** panel) can also forward specific ports to your local machine if needed.
</Note>

***

## Developing in the Container

For a full IDE experience inside the running container:

```bash theme={null}
open code @local
```

Or manually attach via VS Code:

1. Run **Dev Containers: Attach to Running Container…** from the Command Palette
2. Select `grid_core`

See [VS Code with GRID Containers](./vscode-containers) for detailed instructions.

***

## Best Practices

* Use `terminate` to shut down containers when finished
* Leave the `GRID_DATA_DIR` contents in place—GRID support manages updates
* Contact GRID before installing additional system packages to maintain compatibility

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Hello GRID Tutorial" icon="rocket" href="../hello-grid">
    Follow the step-by-step tutorial in your remote terminal.
  </Card>

  <Card title="CLI Reference" icon="terminal" href="./cli">
    Learn all available GRID commands.
  </Card>
</CardGroup>