gpu●aiDocs
CH·02CLI reference

gpu instances open

Open a running instance's web app or web console in your browser

Open a running instance's web app or web console in your browser

Synopsis

Opens the instance's app URL (https://.apps.gpu.ai) in your default browser — JupyterLab for the jupyter template, the served UI for other app templates. With --terminal, opens the instance's browser web console (https://-term.apps.gpu.ai) instead: a shell on the instance with no SSH key setup. Both URLs are protected by HTTP Basic Auth; the login is printed here (and shown on the dashboard instance page). Only template deploys have an app URL; every newly provisioned instance has a console.

The CLI fetches the login with the explicit ?include=credentials opt-in on GET /v1/instances/{id} — bare API reads omit the password so instance responses can be logged safely.

gpu instances open <instance-id> [flags]

Examples

# Open the instance's web app (e.g. JupyterLab) in your default browser
gpu instances open gpu-abc123

# Open a shell on the instance in your browser — works with zero SSH setup
gpu instances open gpu-abc123 --terminal

# Print the URL and login without launching a browser (headless / remote shells)
gpu instances open gpu-abc123 --print

Options

  -h, --help       help for open
      --print      Print the URL and login without launching a browser
      --terminal   Open the browser web console (a shell on the instance) instead of the app

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

← The gpu CLI