> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.nvidia.com/dsx-air/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-air/_mcp/server. # Quick Start ## Supported Browsers NVIDIA DSX Air fully supports the following browsers: * Google Chrome 120 or later * Mozilla Firefox 121 or later NVIDIA DSX Air supports the following browsers on a best-effort basis: * Microsoft Edge * Safari ## Log in to Air Go to [dsx-air.nvidia.com](https://dsx-air.nvidia.com) and click **Login**. Air uses NGC for authentication—sign in with your business email and select your NGC organization. For first-time setup, free trials, and troubleshooting access issues, see [Account Setup](/account-setup). ## Network Simulations After you log in, Air displays a list of simulations associated with your account. ### Create a Simulation To create a simulation, you can either: * Build a custom topology; see [Custom Topology](/custom-topology). * Load a pre-configured demo from the [Demo Marketplace](https://dsx-air.nvidia.com/demos) and customize it; see [Pre-Built Demos](/pre-built-demos). ### Navigate Simulations To interact with your simulation, select the **Topology** tab. This tab provides a variety of options, including options to start and stop the simulation, share it with other users, export it as a JSON file, and ways to access additional features. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/f8f2752d0452fd71807d43737bbf4b9581dfcd61fcb371d7da59bcfebef7ee82/_dot_dot_/docs/assets/images/SimulationActions.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=49abd7b174ebc3ce72a7947b613d39d89cfc1db3916e438530294b3670eaf0fc&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) For detailed information about simulation states, checkpoints, and history, see [Simulation Management](/simulation-management). ### Nodes and Consoles Select a node to open a side panel that displays the node's properties, including its operating system, number of CPUs, memory and storage capacities, and connectors. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/b524260f2cf3710da3be9d38de6b2e3a1f2e1b86570c6b5502a3bd54ce5f8050/_dot_dot_/docs/assets/images/NodesTopology.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=59d615e9cc14ac91f328862dc2c88885e770bc147199df2bde903063c8a7219e&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) Double-click any node to connect to its console. ![example console with login prompt](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/5d667ccf14a7ce079e2d00fb10d1d00e5486e25c1f01ff92fd6ff47aeb6f5479/_dot_dot_/docs/assets/images/Console.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=a0ba0c6215871120846d5993ec90073e98dd3346d959116e7998a4d384fc1d46&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ### Services Enable services to create external connections to your simulation to support integrations: for example, you can use your preferred SSH client to access the `oob-mgmt-server`, run and access web applications such as Grafana or Kibana, or configure SNMP polling. To add a new service to your simulation: 1. In a loaded simulation, select the **Services** tab, then click **+ New Service**. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/49c75323c576c06d75f26fdeabaac0607e6e3c24403fdb877aaa5f3c25662342/_dot_dot_/docs/assets/images/ServicesDropdown.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=a6e64b52057de35190fae0c37b1003e63febbf49dacff9d15231027ad964e829&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) 2. Enter the following information to create a service: * **Service Name** is the name for your service. After you name a service, you can choose to run multiple instances of the same service on different interfaces or ports. * **Interface** is where the connection terminates; typically `eth0` on the `oob-mgmt-server`. * **Service Type** is the service type. NVIDIA DSX Air creates a hyperlink to the URL automatically in the services panel for *SSH*, *HTTP*, or *HTTPS* services. For *Other* services, you can use any port, but Air does not generate a hyperlink. The hyperlink provides a convenient way to copy and paste the service if your browser supports it. * **Service Port** is the internal port where the service terminates. Click **Create**. Air displays the information needed to access the service you created. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/a4d665591bce5d05721d778dd8470065c2282e3d42208fb68ad6750c09691d77/_dot_dot_/docs/assets/images/ServicesList.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=c4ae04ccddd05b007954cac67f55e9e5855bf28da0740a3c04c6bb50a06b78f5&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) To enable SSH on the `oob-mgmt-server`, click **Enable SSH**. This option is only available when the out-of-band network is enabled. SSH password authentication is disabled on the `oob-mgmt-server` by default. To use SSH password authentication, you must upload SSH keys to your user profile; for more information, see [SSH Keys](#ssh-keys). ### Rebuild and Reset Nodes Rebuilding a node restores the node to its original or default configuration. If you create the node from a demo or other snapshot, rebuilding it reverts the node to its original configuration. Resetting a node performs a hard reboot to the node. From a loaded simulation, click the hamburger menu on a node to view rebuild and reset options. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/0298a5adcb6058cc90856b1022b6d8803a4289bc2d65bb4d28985270b58747d7/_dot_dot_/docs/assets/images/RebuildReset.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=f39c653c80f4e05124249ae84af8395a6c7ad77cf1a8c254a0105a85f89c37fe&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) You can also rebuild all nodes in a simulation simultaneously by clicking the ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/5f3d9f38df3844789ffa18a59b400eca4f42b6a5be800f71a61d3b4cd61a2f46/_dot_dot_/docs/assets/images/RebuildAllNodes.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=2fccf38b568506de4c124cb6718c9ee16875146b60ac66f9f5b18388aecff5aa&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **Rebuild All Nodes** button in the **Topology** tab. ### Edit Simulations You can edit important attributes of a simulation with the ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/ebc51fef9b3b7864f7a061ae7eea19b0df46ac06160dc8e35d7abe2e4fb55f98/_dot_dot_/docs/assets/images/Edit.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=4f9fa05135ecde643990ab9ce9e4bb8f71ae3e54758662c7f732dce1654ca207&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) **Edit** button in the **Topology** tab. * **Simulation Name** is the simulation name. Simulations can share the same name. Air assigns a unique identifier to each simulation to differentiate between each one. * **Sleep date** is when the simulation goes into sleep mode automatically; Air saves the state of the simulation and stores it to free up account resources. For details, see [Simulation Management](/simulation-management). ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/bea29f41689778bd3db4e00f3a625eacc1d12385cded5a12745b0fff8d8ab68f/_dot_dot_/docs/assets/images/EditSim.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=da5d343621de4a44ccbe9199290694f15922b488f9e449c4287bf982f658ee57&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) ## API Authentication To authenticate with the NVIDIA DSX Air API, use NGC API keys. For detailed information about generating and using API keys, see [API Authentication](/authentication). ## SSH Keys To view your SSH keys, click your username in the UI and select **Settings**. To enable the SSH service on simulations, you must add SSH keys to your authentication settings. Any SSH keys that you add are included automatically in your simulation's list of authorized keys under the `oob-mgmt-server`. To add an SSH key, fill in the **Name** and **Public Key** fields, then select **Add**. ![](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/dsx-air.docs.buildwithfern.com/635cd164cf85ffb095eec47ff6a0d2ec6ad08259e3cd29c9d7bef5aaf575246d/_dot_dot_/docs/assets/images/SSHKey.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260915%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260915T165622Z&X-Amz-Expires=604800&X-Amz-Signature=857cee97541d7339afd49fa4e8f6b0f36e9b1e154a5a651cecd11b0c67348aa2&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject) You can delete SSH keys if you no longer need them, or if they become compromised. ## Related Information * [Cumulus Linux in a Virtual Environment](https://docs.nvidia.com/networking-ethernet-software/cumulus-linux/Cumulus-Linux-in-a-Virtual-Environment/)