> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siderolabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Interactive Dashboard

> A tool to inspect the running Talos machine state on the physical video console.

export const VersionWarningBanner = () => {
  const latestVersion = "v1.13";
  const [latestUrl, setLatestUrl] = useState(null);
  const [currentVersion, setCurrentVersion] = useState(null);
  const [isBeta, setIsBeta] = useState(false);
  const parseVersion = v => v.replace("v", "").split(".").map(Number);
  const isGreaterVersion = (a, b) => {
    const [aMajor, aMinor] = parseVersion(a);
    const [bMajor, bMinor] = parseVersion(b);
    if (aMajor > bMajor) return true;
    if (aMajor === bMajor && aMinor > bMinor) return true;
    return false;
  };
  useEffect(() => {
    if (typeof window === "undefined") return;
    const {pathname, hash, search} = window.location;
    const match = pathname.match(/\/talos\/(v\d+\.\d+)\//);
    if (!match) return;
    const detectedVersion = match[1];
    if (detectedVersion === latestVersion) return;
    setCurrentVersion(detectedVersion);
    if (isGreaterVersion(detectedVersion, latestVersion)) {
      setIsBeta(true);
    }
    const newPath = pathname.replace(`/talos/${detectedVersion}/`, `/talos/${latestVersion}/`);
    setLatestUrl(`${newPath}${search}${hash}`);
  }, []);
  if (!latestUrl || !currentVersion) return null;
  return <div className="not-prose sticky top-6 z-50 my-6">
      <div className="border border-yellow-500/30 bg-yellow-500/10 px-4 py-3 rounded-xl">
        <div className="text-sm">
          {isBeta ? <>
              ⚠️ You are viewing a <strong>beta version</strong> of Talos ({currentVersion}).
              This version may be unstable.
              <a href={latestUrl} className="ml-2 underline text-yellow-400 hover:text-yellow-300 font-medium">
                View latest stable version {latestVersion} →
              </a>
            </> : <>
              ⚠️ You are viewing an older version of Talos ({currentVersion}).
              <a href={latestUrl} className="ml-2 underline text-yellow-400 hover:text-yellow-300 font-medium">
                View the latest version {latestVersion} →
              </a>
            </>}
        </div>
      </div>
    </div>;
};

<VersionWarningBanner />

Interactive dashboard is enabled for all Talos platforms except for SBC images.
The dashboard can be disabled with kernel parameter `talos.dashboard.disabled=1`.

<iframe
  width="560"
  height="315"
  src="https://www.youtube.com/embed/52Wmkb0H-98"
  title="Talos dashboard overviewr"
  frameborder="0"
  allow="accelerometer;
autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
  referrerpolicy="strict-origin-when-cross-origin"
  allowfullscreen
/>

The dashboard runs only on the physical video console (not serial console) on the 2nd virtual TTY.
The first virtual TTY shows kernel logs same as in Talos `<1.4.0>`.
The virtual TTYs can be switched with `<Alt+F1>` and `<Alt+F2>` keys.

Keys `<F1>` - `<Fn>` can be used to switch between different screens of the dashboard.

The dashboard is using either UEFI framebuffer or VGA/VESA framebuffer (for legacy BIOS boot).

## Dashboard resolution control

On legacy BIOS systems, the screen resolution can be adjusted with the [`vga=` kernel parameter](https://docs.kernel.org/fb/vesafb.html).

In modern kernels and platforms, this parameter is often ignored. For reliable results, it is recommended to boot with **UEFI**.

When running in **UEFI mode**, you can set the screen resolution through your hypervisor or UEFI firmware settings.

## Summary screen (`F1`)

<img src="https://mintcdn.com/siderolabs-fe86397c/5b1BOYbajr1Drk9p/talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-1.png?fit=max&auto=format&n=5b1BOYbajr1Drk9p&q=85&s=04bacb85226ef3d5d9b4155b61b94120" alt="Interactive Dashboard Summary Screen" width="920" data-path="talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-1.png" />

The header shows brief information about the node:

* hostname
* Talos version
* uptime
* CPU and memory hardware information
* CPU and memory load, number of processes

Table view presents summary information about the machine:

* UUID (from SMBIOS data)
* Cluster name (when the machine config is available)
* Machine stage: `Installing`, `Upgrading`, `Booting`, `Maintenance`, `Running`, `Rebooting`, `Shutting down`, etc.
* Machine stage readiness: checks Talos service status, static pod status, etc. (for `Running` stage)
* Machine type: controlplane/worker
* Number of members discovered in the cluster
* Kubernetes version
* Status of Kubernetes components: `kubelet` and Kubernetes controlplane components (only on `controlplane` machines)
* Network information: Hostname, Addresses, Gateway, Connectivity, DNS and NTP servers

Bottom part of the screen shows kernel logs, same as on the virtual TTY 1.

## Monitor screen (`F2`)

<img src="https://mintcdn.com/siderolabs-fe86397c/5b1BOYbajr1Drk9p/talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-2.png?fit=max&auto=format&n=5b1BOYbajr1Drk9p&q=85&s=8a25f4dc76b59bec2ac28df16627032c" alt="Interactive Dashboard Summary Screen" width="920" data-path="talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-2.png" />

Monitor screen provides live view of the machine resource usage: CPU, memory, disk, network and processes.

## Network config screen (`F3`)

> Note: network config screen is only available for `metal` platform.

<img src="https://mintcdn.com/siderolabs-fe86397c/5b1BOYbajr1Drk9p/talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-3.png?fit=max&auto=format&n=5b1BOYbajr1Drk9p&q=85&s=70029f5ce45ec680b54d8cfefd3aebfa" alt="Interactive Dashboard Summary Screen" width="920" data-path="talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-3.png" />

Network config screen provides editing capabilities for the `metal` [platform network configuration](../platform-specific-installations/bare-metal-platforms/network-config).

The screen is split into three sections:

* the leftmost section provides a way to enter network configuration: hostname, DNS and NTP servers, configure the network interface either via DHCP or static IP address, etc.
* the middle section shows the current network configuration.
* the rightmost section shows the network configuration which will be applied after pressing "Save" button.

Once the platform network configuration is saved, it is immediately applied to the machine.

## Resource Viewer (`F4`/`F3`)

<img src="https://mintcdn.com/siderolabs-fe86397c/FzHQxQ5DCKXy8JWK/talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-4.png?fit=max&auto=format&n=FzHQxQ5DCKXy8JWK&q=85&s=a25b141f1735861a625f265fd60ed244" alt="Interactive Dashboard Resource Viewer Screen" width="920" data-path="talos/v1.13/deploy-and-manage-workloads/images/interactive-dashboard-4.png" />

Resource viewer screen provides a way to inspect the running Talos machine state when using the video console is the only option (e.g. when the network is not working and `talosctl` cannot be used).
When using the console, only non-sensitive resources are available, while when using `talosctl dashboard` command, available resources depend on the RBAC permissions of the user.

Resource viewer can be used to inspect network links, hardware devices, disks, etc.
The list of resources can be filtered by pressing `/` key and entering the search query. Use `/` to clear or change the filter.

Pressing `Enter` on a resource type shows a list of available resources of this type, and pressing `Enter` on a specific resource shows detailed information about it in YAML format.
