> For the complete documentation index, see [llms.txt](https://kb.mago.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.mago.io/mago-stage/admin-portal/displays/manage-display-software-and-commands.md).

# Manage display software and commands

Use the **Software** page to review the receiver application, send available updates, and issue remote commands.

The display must be online to receive commands and updates.

### Open the Software page

1. In the Administration Portal, select **Displays**.
2. Open the required display.
3. Select **Software**.

### Review software status

The page can show:

* Installed application version
* Application status
* Display usage status
* Available update
* Update history
* Command history

| Status            | Meaning                                                            |
| ----------------- | ------------------------------------------------------------------ |
| **App status**    | Indicates whether the Mago Stage application is currently running. |
| **Usage status**  | Indicates whether the display is idle or currently in use.         |
| **Update status** | Shows whether a managed update is available.                       |

Some status information may be unavailable when the display is offline or does not support the corresponding management feature.

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2F8C1lhOw1fHXDazBOVkj4%2Fimage.png?alt=media&amp;token=c90cfffa-1d0c-44dc-a7da-72183396c447" alt=""><figcaption></figcaption></figure>

### Update the display

When a newer managed release is available:

1. Open the display’s **Software** page.
2. Review the installed and available versions.
3. Select **Push Update**.
4. Confirm the action if prompted.
5. Monitor **Update History**.
6. Confirm the installed version after the display reconnects.

{% hint style="warning" %}
Test application updates on a limited number of displays before deploying them more widely.
{% endhint %}

If the portal reports that update status is unavailable, confirm that the display platform supports managed updates and that the update service is configured correctly.

### Send application commands

The **Commands** area can include:

| Command            | Result                                                      |
| ------------------ | ----------------------------------------------------------- |
| **Start App**      | Starts the Mago Stage application on the display.           |
| **Stop App**       | Stops the Mago Stage application.                           |
| **Restart App**    | Stops and restarts the application.                         |
| **Remote Control** | Starts an authorized remote-control session when supported. |

Select the required command and confirm it when prompted.

### Verify command completion

A successful portal notification confirms that the command was sent. It does not always confirm that the action completed successfully on the receiver.

After sending a command:

1. Allow time for the receiver to process it.
2. Refresh the display status.
3. Review **Command History**.
4. Confirm the result on the physical display when possible.

If the command does not take effect, confirm that the receiver remains online and can communicate with the Mago Stage environment.

### Remote control

Use **Remote Control** only when:

* The display is online.
* Remote control is enabled for the deployment.
* Your account has the required permission.
* The session is authorized by your organization.

Remote sessions and administrative actions may be recorded in the audit history.
