Skip to main content
Authenticate with Ultra Hub to enable cloud features like gateway linking, telemetry sync, and team management.

​
Usage

ultra login [flags]

​
Flags

FlagDefaultDescription
--hubhttps://hub.ultra.securityUltra Hub URL

​
Examples

# Login to Ultra Hub
ultra login

# Login to a self-hosted hub
ultra login --hub https://hub.mycompany.com

​
How It Works

  1. Ultra starts a local callback server on port 19284
  2. Your default browser opens to the Hub authentication page
  3. You sign in or create an account
  4. Hub redirects back to the local server with credentials
  5. Credentials are saved to your config file
If the browser can’t be opened automatically, Ultra displays the URL for manual navigation. The login flow times out after 5 minutes.

​
After Login

Your credentials are stored in ~/.config/ultra/config.yaml. Next step: 
ultra link   # Link this gateway to a workspace

​
Session Management

  • If already logged in, Ultra tells you and exits
  • If your session has expired, Ultra proceeds with re-authentication
  • Credentials persist across Ultra restarts
  • Use ultra logout to clear credentials