***

title: Managing Registered Compute
description: >-
Share access, forward ports, view device details, and deregister machines from
NVIDIA Brev.
------------

Once your machine is registered with Brev, you can share it with teammates, forward ports, and manage its lifecycle.

## Viewing Registered Compute

{/* TODO: SME review — console UI for viewing registered compute */}

Registered machines appear in the Brev console alongside cloud GPU instances. You can view each machine's hardware profile, connection status, and authorized users.

## Sharing Access

### Granting SSH Access

Run this command **on the registered machine** to grant SSH access to a teammate:

```bash
brev grant-ssh
```

An interactive selector shows all members of your organization (excluding yourself). Select the user to grant access and enter the SSH port. Once granted, they can connect from their own machine:

```bash
brev shell <machine-name>
```

{/* TODO: SME review — UI flow for sharing access */}

<Callout intent="info">
  As a security measure, `brev grant-ssh` removes `~/.brev/credentials.json` before granting access.
</Callout>

### Revoking SSH Access

To revoke a user's access, run this **on the registered machine**:

```bash
brev revoke-ssh
```

An interactive selector shows all Brev-managed SSH keys with a key preview and associated user. Select the key to revoke. This performs a two-stage revocation:

1. Removes the SSH key from the local machine
2. Sends an RPC to the Brev server to revoke server-side access

{/* TODO: SME review — UI flow for revoking access */}

## Port Forwarding

Forward ports from the registered machine to your local machine using `brev port-forward`:

```bash
# Forward a single port
brev port-forward my-dgx-spark --port 8888:8888

# Forward multiple ports
brev port-forward my-dgx-spark --port 8888:8888 --port 6006:6006
```

### Supported Protocols

Port forwarding supports TCP and UDP. The protocol is specified via the `OpenPort` RPC:

| Protocol | Use Case                                |
| -------- | --------------------------------------- |
| TCP      | Web servers, Jupyter, TensorBoard, APIs |
| UDP      | Streaming, real-time applications       |

### Common Port Forwards

| Service       | Command            |
| ------------- | ------------------ |
| Jupyter       | `--port 8888:8888` |
| TensorBoard   | `--port 6006:6006` |
| Streamlit     | `--port 8501:8501` |
| Gradio        | `--port 7860:7860` |
| NIM Inference | `--port 8000:8000` |

## Deregistering a Machine

To fully remove a machine from Brev, run this **on the registered machine**:

```bash
brev deregister
```

This performs a complete cleanup:

1. Unregisters the machine from the Brev server
2. Removes all SSH keys
3. Uninstalls the NetBird VPN agent
4. Deletes the local registration file (`/etc/brev/device_registration.json`)

<Callout intent="warning">
  Deregistering removes all access. Teammates will no longer be able to connect to this machine through Brev. You can re-register at any time with `brev register`.
</Callout>