Enable a vSphere Bitfusion client that is installed on a Tanzu Kubernetes Grid (TKG) container, a different vCenter Server instance, or a bare metal machine.

To enable a vSphere Bitfusion client that is not part of the same vCenter Server instance as your servers, follow the procedure. You must generate an authorization token, download the related tar file, and extract the contents of the file in the filesystem of your client.

To enable a client that is part of the same vCenter Server instance as your servers, see Enable the vSphere Bitfusion Client.


  • Verify that you have installed a vSphere Bitfusion 2.5 server or later.
  • Verify that the version of your vSphere Bitfusion client is the same version as your vSphere Bitfusion servers or earlier. See Upgrading vSphere Bitfusion.
  • Verify that the vSphere Bitfusion client has network access to the servers in your cluster.


  1. In the vSphere Client, select Menu > Bitfusion.
  2. On the Tokens tab, select New Token.
  3. In the Create Token dialog box, enter a description, and click Create.
  4. Select the token from the list, click Download, and save the tar file to your local machine.
  5. Copy the tar file to the filesystem of your client machine or machines.
  6. Extract the contents of the tar file and copy them to the following folders.
    1. Copy ca.crt to /etc/bitfusion/tls.
    2. Copy client.yaml to ~/.bitfusion.
    3. Copy servers.conf to ~/.bitfusion.
  7. In the terminal of the machine, add users to the Bitfusion group by running the sudo usermod -aG bitfusion username command.
  8. (Optional) Verify that the users were successfully added to the vSphere Bitfusion group.
    1. Log out and log in the terminal of the machine.
    2. In the terminal, run the groups command.
    The users and their associated groups are listed.
  9. (Optional) Verify that the vSphere Bitfusion client is working by listing the available GPUs in the vSphere Bitfusion deployment by running the bitfusion list_gpus command.


You have successfully enabled the vSphere Bitfusion client.

What to do next

Start an application in the vSphere Bitfusion client. After the first run, the vSphere Bitfusion client joins the cluster.