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

Select the organization, machine, SSH port, Brev user, and Linux user. You can select yourself to grant your own account access. Once granted, the user can log in with brev login and 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

Select the organization, machine, and SSH access entry to revoke. Each entry identifies a Brev user, Linux user, and port. Confirm to revoke that access on the Brev server.

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 the associated Brev SSH entries
3. Uninstalls the NetBird VPN agent
4. Deletes the local registration file (/etc/brev/device_registration.json)