Use the web dashboard

The Anbox Cloud Dashboard offers a web GUI from where developers can create, manage, and even stream applications from their web browser.
The dashboard is useful if you are new to Anbox Cloud or want a simple management interface.

Starting in 1.9.0, the dashboard replaces the old Dev UI.

Note: The web dashboard is more oriented toward developers than end-users. However, it only uses available APIs and SDKs, and can be a good example to build your own web-based platform.

Installation

The dashboard comes pre-installed when you deploy Anbox Cloud with the streaming stack or the Anbox Cloud Appliance. It sits behind a reverse proxy for performance and security reasons.

Usage

To access the dashboard, go to https://<your-machine-address>/.

Hint: The dashboard uses self-signed certificates. You might see a warning from your browser and have to accept the certificates manually.

Granting access

Instead of implementing its own user management, the dashboard relies on OAuth for user authentication. The only OAuth provider supported right now is Ubuntu One. Future versions of Anbox Cloud will allow using other OAuth providers.

If you haven’t registered an Ubuntu One account yet, you can do that at https://login.ubuntu.com/.

Before you can log into the dashboard, you must register your Ubuntu One account with the dashboard to grant it access.

Register a Ubuntu One account in Anbox Cloud

On a regular Anbox Cloud deployment, use the following Juju action to register a Ubuntu One account:

juju run-action anbox-cloud-dashboard/0 --wait register-account email=<Ubuntu One email address>

You will see output similar to the following:

unit-anbox-cloud-dashboard-0:
  UnitId: anbox-cloud-dashboard/0
  id: "157"
  results:
    Stdout: |
      Visit https://10.10.10.10/register?token=eyJ0...-Td7A to create the new user
  status: completed
  timing:
    completed: 2021-02-10 14:04:46 +0000 UTC
    enqueued: 2021-02-10 14:04:44 +0000 UTC
    started: 2021-02-10 14:04:44 +0000 UTC

Register a Ubuntu One account in Anbox Cloud Appliance

If you followed the instructions in Install Appliance to install the Anbox Cloud Appliance, you already registered your Ubuntu One account.

To add more accounts, use the following command:

$ anbox-cloud-appliance dashboard register <Ubuntu One email address>

Accessing the resulting link will create the account and ask you to login via Ubuntu One. You only need to do this step once per user you want to grant access to the dashboard.

The generated link is valid for one hour.

Creating applications

Creating applications through the dashboard is done the same way as you would do with amc (see Managing Applications).
Note that more advanced scenarios might not yet be possible via the dashboard and require going through amc.

Streaming applications

The dashboard comes with in-browser streaming capabilities through WebRTC.

Note: The dashboard uses the Streaming SDK under the hood.

You can select any application you previously created and start a streaming session.

For more information about the Streaming Stack, visit https://anbox-cloud.io/docs/manage/streaming-android-applications.


Last updated 9 days ago.