mirror of
https://github.com/NVIDIA/dgx-spark-playbooks.git
synced 2026-06-18 04:22:21 +00:00
105 lines
3.9 KiB
Markdown
105 lines
3.9 KiB
Markdown
# Station Register 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 the command line 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
|
||
|
||
## Instructions
|
||
|
||
## Step 1. Login 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 Popup 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
|
||
|
||
## 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 an **Available** 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:
|
||
|
||
* **Share Access Anywhere:** Access your machine from anywhere and share access with others through the Brev UI under [Registered Compute](https://brev.nvidia.com/org/environments?tab=registered-compute).
|
||
|
||
## 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 “Deregister” 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` |
|