Skip to content

Manual Registration

While Backend.AI GO handles local resources automatically, connecting to external resources—like a corporate Backend.AI Cluster or a colleague's high-performance workstation—requires manual registration. This ensures security and explicit control over where your data is sent.

Connecting to a Backend.AI Cluster

If your organization uses Backend.AI Enterprise, you can connect your GO client directly to the cluster.

Prerequisites

You need the following information from your cluster administrator:

  • Endpoint URL: The API address of the cluster (e.g., https://api.my-cluster.ai).
  • Access Key: Your public identifier.
  • Secret Key: Your private signing key (never share this).

Steps

  1. Open Settings by clicking the gear icon in the sidebar.
  2. Navigate to the Mesh (or Network) tab.
  3. Scroll to the Backend.AI Clusters section.
  4. Click Add Cluster.
  5. Enter the details:
    • Name: A friendly name for this connection (e.g., "Company GPU Cluster").
    • Endpoint URL: The full URL provided by your admin.
    • Access Key: Paste your access key.
    • Secret Key: Paste your secret key.
  6. Click Save.

The system will immediately attempt to verify the connection. If successful, the status indicator will turn green, and models available on the cluster will start appearing in your model selection list.

Connecting to a Peer (Backend.AI GO)

Note: Direct peer-to-peer connection interfaces are currently being standardized. For now, you typically connect to a peer by treating it as a remote router.

  1. Ensure the target machine is running Backend.AI GO and is accessible over the network (check firewalls).
  2. In the Mesh settings, look for External Routers or similar.
  3. Add the IP address and port (default is usually 8080 or 11434 depending on configuration) of the target machine.