# aspire tray start command

## Name

`aspire tray start` - Start or restore the tray icon.

## Synopsis

```bash title="Aspire CLI"
aspire tray start [options]
```

## Description

The `aspire tray start` command starts the Aspire tray companion, or restores its icon if it's already running. The tray discovers local AppHosts, shows their health, and lets you stop an exact instance, open the dashboard, start AppHosts, manage pins and history, and change settings. On Linux, the menu also provides folder, copy-path, and VS Code actions, and an opt-in XDG login startup setting.

On GNOME, the native menu exports colored dots for each AppHost's aggregate resource health and a gray square for stopped projects. AppHosts with no visible resources show "No resources" rather than an unknown health state. Some GNOME AppIndicator versions suppress icons on submenu headers, so health text is retained.

The command requires a native CLI bundle that includes the tray companion. For platform requirements, see [aspire tray](../aspire-tray/).

**Note:** The command doesn't change desktop configuration or register login startup automatically.

## Options

The following options are available:

- <Include relativePath="reference/cli/includes/option-help.md" />

- <Include relativePath="reference/cli/includes/option-log-level.md" />

- <Include relativePath="reference/cli/includes/option-non-interactive.md" />

- <Include relativePath="reference/cli/includes/option-nologo.md" />

- <Include relativePath="reference/cli/includes/option-banner.md" />

- <Include relativePath="reference/cli/includes/option-wait.md" />

## Examples

- Start the tray:

  ```bash title="Aspire CLI"
  aspire tray start
  ```

## See also

- [aspire tray command](../aspire-tray/)
- [aspire tray stop command](../aspire-tray-stop/)