Managing Registered Compute

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

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:

$
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:

$
brev shell <machine-name>

Revoking SSH Access

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

$
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

Port Forwarding

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

$
# 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:

Common Port Forwards

Deregistering a Machine

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

$
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)