> 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

Run:ai Command-line Interface

### Synopsis

runai - The Run:ai Researcher Command Line Interface
	
Description:  
  A tool for managing Run:ai workloads and monitoring available resources.
  It provides researchers with comprehensive control over their AI development environment.


```
runai [flags]
```

### Options

```
      --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
  -h, --help                 help for runai
  -q, --quiet                enable quiet mode, suppress all output except error messages
      --verbose              enable verbose mode
```

### SEE ALSO

* [runai application](/run-ai/self-hosted/reference/cli/runai/application/runai-application)	 - ai application management
* [runai auth](/run-ai/self-hosted/reference/cli/runai/auth/runai-auth)	 - Authentication related commands
* [runai cluster](/run-ai/self-hosted/reference/cli/runai/cluster/runai-cluster)	 - cluster management
* [runai compute](/run-ai/self-hosted/reference/cli/runai/compute/runai-compute)	 - Compute resource asset management
* [runai config](/run-ai/self-hosted/reference/cli/runai/config/runai-config)	 - configuration management
* [runai credential](/run-ai/self-hosted/reference/cli/runai/credential/runai-credential)	 - Credential asset management
* [runai datasource](/run-ai/self-hosted/reference/cli/runai/datasource/runai-datasource)	 - Data Source asset management
* [runai datavolume](/run-ai/self-hosted/reference/cli/runai/datavolume/runai-datavolume)	 - Data volume asset management
* [runai department](/run-ai/self-hosted/reference/cli/runai/department/runai-department)	 - department management
* [runai diagnostics](/run-ai/self-hosted/reference/cli/runai/diagnostics/runai-diagnostics)	 - system diagnostics and troubleshooting tools
* [runai environment](/run-ai/self-hosted/reference/cli/runai/environment/runai-environment)	 - Environment asset management
* [runai inference](/run-ai/self-hosted/reference/cli/runai/inference/runai-inference)	 - inference management
* [runai kubeconfig](/run-ai/self-hosted/reference/cli/runai/kubeconfig/runai-kubeconfig)	 - kubeconfig management
* [runai login](/run-ai/self-hosted/reference/cli/runai/login/runai-login)	 - login to the control plane
* [runai logout](/run-ai/self-hosted/reference/cli/runai/logout/runai-logout)	 - logout of the system
* [runai mpi](/run-ai/self-hosted/reference/cli/runai/mpi/runai-mpi)	 - alias for mpi management
* [runai my-credential](/run-ai/self-hosted/reference/cli/runai/my-credential/runai-my-credential)	 - manage personal credentials associated with the current user
* [runai node](/run-ai/self-hosted/reference/cli/runai/node/runai-node)	 - node management
* [runai nodepool](/run-ai/self-hosted/reference/cli/runai/nodepool/runai-nodepool)	 - node pool management
* [runai project](/run-ai/self-hosted/reference/cli/runai/project/runai-project)	 - project management
* [runai pvc](/run-ai/self-hosted/reference/cli/runai/pvc/runai-pvc)	 - PVC management
* [runai pytorch](/run-ai/self-hosted/reference/cli/runai/pytorch/runai-pytorch)	 - alias for pytorch management
* [runai report](/run-ai/self-hosted/reference/cli/runai/report/runai-report)	 - [Experimental] report management
* [runai template](/run-ai/self-hosted/reference/cli/runai/template/runai-template)	 - workload template management
* [runai training](/run-ai/self-hosted/reference/cli/runai/training/runai-training)	 - training management
* [runai upgrade](/run-ai/self-hosted/reference/cli/runai/upgrade/runai-upgrade)	 - upgrades the CLI to the latest version
* [runai version](/run-ai/self-hosted/reference/cli/runai/version/runai-version)	 - show the current version of the CLI
* [runai whoami](/run-ai/self-hosted/reference/cli/runai/whoami/runai-whoami)	 - show the current logged in user
* [runai workload](/run-ai/self-hosted/reference/cli/runai/workload/runai-workload)	 - workload management
* [runai workload-type](/run-ai/self-hosted/reference/cli/runai/workload-type/runai-workload-type)	 - workload type management
* [runai workspace](/run-ai/self-hosted/reference/cli/runai/workspace/runai-workspace)	 - workspace management