> This page is for Self-Hosted, version v3.0 (default).
> For other versions, use one of these documentation indexes:
> - v3.0 (default): https://docs.nvidia.com/run-ai/self-hosted/v3.0/llms.txt
> - v2.26: https://docs.nvidia.com/run-ai/self-hosted/v2.26/llms.txt
> - v2.25: https://docs.nvidia.com/run-ai/self-hosted/v2.25/llms.txt
> - v2.24: https://docs.nvidia.com/run-ai/self-hosted/v2.24/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/run-ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/run-ai/_mcp/server.

# runai login

login to the control plane

```
runai login [flags]
```

### Examples

```

  # Login using browser
  runai login

  # Login using SSO with remote browser
  runai login sso
  runai login remote-browser

  # Login using username and password without browser
  runai login user -u <username> 

  # Login using browser with specific port and host
  runai login --listen-port=43121 --listen-host=localhost

```

### Options

```
  -h, --help                 help for login
      --listen-host string   the host to listen on for the authentication callback (for browser mode only) (default "localhost")
      --listen-port int      the port to listen on for the authentication callback (for browser mode only) (default 43121)
```

### Options inherited from parent commands

```
      --config-file string   config file name; can be set by environment variable RUNAI_CLI_CONFIG_FILE (default "config.json")
      --config-path string   config path; can be set by environment variable RUNAI_CLI_CONFIG_PATH
  -d, --debug                enable debug mode
  -q, --quiet                enable quiet mode, suppress all output except error messages
      --verbose              enable verbose mode
```

### SEE ALSO

* [runai](/run-ai/self-hosted/reference/cli/runai)	 - Run:ai Command-line Interface
* [runai login access-key](/run-ai/self-hosted/reference/cli/runai/login/runai-login-access-key)	 - login as a service account or a user using an access key
* [runai login sso](/run-ai/self-hosted/reference/cli/runai/login/runai-login-sso)	 - login using sso without browser
* [runai login user](/run-ai/self-hosted/reference/cli/runai/login/runai-login-user)	 - login for local user without browser