Managing Brev Connect

Once you’ve connected a machine with Brev Connect, you can share it with teammates, forward ports, and manage its lifecycle.

Viewing Brev Connect Machines

Brev Connect 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 Brev Connect 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 Brev Connect 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 Brev Connect 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 Connect, run this on the Brev Connect 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)