Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ultra.security/llms.txt

Use this file to discover all available pages before exploring further.

Link this Ultra gateway to a workspace in Ultra Hub. After linking, the gateway syncs traces and audit events to Hub.

​
Usage

ultra link [flags]

​
Flags

FlagShortDefaultDescription
--workspace-wWorkspace ID to link to
--name-nhostnameName for this gateway

​
Examples

# Link interactively (choose workspace)
ultra link

# Link to a specific workspace
ultra link --workspace ws_xxxxxxxxxxxx

# Link with a custom gateway name
ultra link --name "My MacBook"

​
Prerequisites

You must be logged in first: 
ultra login

​
Interactive Flow

  1. Fetches your available workspaces from Hub
  2. Shows a selector to choose a workspace
  3. Prompts for a gateway name (defaults to hostname)
  4. Registers the gateway with Hub
  5. Saves gateway ID and workspace ID to config

​
After Linking

ultra start   # Traces and events will sync to Hub automatically

​
Already Linked

If the gateway is already linked, Ultra shows the current gateway ID and workspace. Use ultra unlink to disconnect before re-linking.