dgx-spark-playbooks/nvidia/station-brev/README.md

# Register DGX Station to Brev

> Link your DGX Station to Brev for remote access and sharing

## Table of Contents

- [Overview](#overview)
- [Instructions](#instructions)
- [Troubleshooting](#troubleshooting)

---

## Overview

## Basic idea

NVIDIA Brev is an AI development platform that makes GPU environments remotely accessible, shareable, and easy to standardize using preconfigured setups called Launchables. 

This walkthrough will help you connect your NVIDIA DGX Station to Brev so it shows up as a managed GPU environment in Brev. After a one-time registration, your Station becomes remotely accessible and shareable.

## What you'll accomplish

You’ll register your DGX Station with Brev and it will be visible as a healthy node in the Brev web UI and CLI, ready to share access and accept workloads whenever needed.

## What to know before starting

While Brev automates the complex configuration, understanding a few key concepts when establishing the initial connection will be useful:

* **Terminal Basics**:
  * Familiarity with command-line use to run a few simple setup commands.

## Prerequisites

You will also need the following:

* NVIDIA DGX Station with GB300 GPU
* **Brev Account**:
  * Have an NVIDIA Brev account. [Create an NVIDIA Brev account](https://login.brev.nvidia.com/signin) if you don’t have one.

* **Permissions**:
  * You have administrative (root or sudo) access on the DGX Station device to run the registration command.

## Time & risk

* **Estimated time:** 5-10 minutes
* **Risk level:** Low - Registration configures the Station for secure remote access without altering your existing workloads
* **Rollback:** The Brev configuration can be removed through the UI and CLI
* **Last Updated:** 05/29/2026
  * First Publication

## Instructions

## Step 1. Log in to Brev

Go to the [Brev UI](https://brev.nvidia.com), log in, and confirm you’re in the correct org (by clicking the org button on the top right-hand side of the page). Once logged in, go to the [Registered Compute](https://brev.nvidia.com/org/environments?tab=registered-compute) section under the "GPU" tab in the main navigation.

Click the “Register Compute” button and follow the instructions in the pop-up window.

## Step 2. Complete Pop-up Instructions

* Install the Brev CLI
* Configure your compute
    * Add a name for compute
    * To configure SSH, ensure the “Enable SSH access” toggle is on
* Run the registration command

> [!IMPORTANT]
> Run the Brev CLI install command **without `sudo`**. Prefixing the installer with `sudo` writes the `brev` binary into root's home directory, which is not on your user shell's `PATH` — the next command will fail with `brev: command not found`. Copy the install command from the pop-up and run it as your normal user.

## Step 3. Follow Registration Flow

In the CLI, you’ll be walked through registration. Go through the flow until registration is complete.

## Step 4. Confirm DGX Station in Brev UI

* Go to the [Brev UI](https://brev.nvidia.com)
* Navigate to the [Registered Compute](https://brev.nvidia.com/org/environments?tab=registered-compute)
* Confirm that the DGX Station appears as a registered node with a **Connected** status 

## Step 5. Next Steps

Your DGX Station is now integrated into Brev as a secure, remotely accessible GPU environment.

Now that your hardware is connected, you can:

* **Access your machine from anywhere:** Open the [Brev UI](https://brev.nvidia.com) and launch a session from [Registered Compute](https://brev.nvidia.com/org/environments?tab=registered-compute).
* **Share access with others:** Invite teammates to your DGX Station from the Brev UI:
    * Go to the [Brev UI](https://brev.nvidia.com) and open [Registered Compute](https://brev.nvidia.com/org/environments?tab=registered-compute).
    * Find your DGX Station in the list and open the row's three-dot (⋯) menu.
    * Select **Share Access**.
    * Enter the email address of the person you want to share with.
    * Choose their role / permission level.
    * Confirm to send the invitation.

## Step 6. Cleanup

If you ever decide to unregister your DGX Station with Brev, you can either do so through the Brev UI or the Brev CLI.

With the CLI simply run:

```bash
brev deregister
```

In the UI:
* Go to the [Brev UI](https://brev.nvidia.com)
* Navigate to the section listing “GPU Environments” and look under “Registered Compute”
* Click the “Remove” menu item on the device you wish to delete from Brev.
* Confirm your selection.

## Troubleshooting

| Symptom | Cause | Fix |
|---------|-------|-----|
| Your DGX Station is showing up in the wrong org | It was registered to the wrong org | Run `brev set <my-org>` and then redo the registration process. |
| Unable to `brev shell <name>` | Need to refresh | `brev refresh`. |