oosVersion 2.1

Application Direct Display Output

Configure direct application output via HDMI or VGA ports for Container or Hypervisor applications.

Use direct display output to show an application on a monitor connected directly to the device. The device must have an HDMI or VGA display port. Both procedures below use HDMI.

A Container packages a program with its runtime environment. In this example, a browser container opens the web page of an application in another container. A Hypervisor runs virtual machines (VMs) and can output a VM's display to the monitor. Choose the procedure for your application type.

By default, the HDMI output runs a Chromium browser container pointing to the OOS login page. However, users can customize the HDMI output to display any target application interface.

Before starting, prepare a monitor that connects to the device's HDMI port and identify the application to display. The application names, address, and ports below are examples for this guide. Configure the service URL and port provided by the application.


Container: Displaying an Application Web Page

  1. Deploy the ChromiumBrowser and water-quality-monitor container applications from the Controller or App Store.

Deploy ChromiumBrowser and water-quality-monitor container apps

  1. Navigate to the Application > Information page, select Container, and click Edit from the Action column for the water-quality-monitor container.

Edit water-quality-monitor container settings

  1. Check the container port mapping. A port is a number used by a service. In the screenshot, both Public Port and Private Port are 8080. Note the actual settings for the URL you will enter next.

Check container port settings

  1. Go back to Application > Information, select Container, and click Edit from the Action column for the ChromiumBrowser container.
  2. Under Environment Variables (settings passed to the program), find SERVICEURL, the URL the browser should open. The original example uses http://172.17.0.1:8080, where :8080 specifies the port. Enter the full service URL provided by the application, using the port checked in step 3.

Update SERVICEURL environment variable for ChromiumBrowser

  1. Click the Apply button. Once configured, connect your display to the device's HDMI port to mirror the application output.

HDMI external display output effect

Confirm that the monitor shows the target application rather than the original OOS login page. If it does not, check the application status, port, and SERVICEURL, then check the HDMI connection.


Hypervisor: Displaying a Virtual Machine

First create the virtual machine (VM) to display. The following steps use the OOS graphical user interface (GUI), where you work with menus and fields rather than command-line instructions.

  1. Go to the Application > Information page, select Hypervisor, and click Edit from the Action column for the target VM (e.g., ubuntu-server).

Edit Hypervisor ubuntu-server settings

  1. Select Start Projection and connect your display to the device's HDMI port to directly project the VM interface.

To stop projection, go to Application > Information > Hypervisor, click Edit for ubuntu-server, and select Stop Projection (or uncheck Start Projection).

Start Projection setting screen

After enabling projection, confirm that the monitor shows the target VM. After stopping projection, confirm that its display output stops. Stopping projection stops display output; do not treat it as having used Stop to stop the VM.