# Dashboard Apps

> **📝 Note**: This is a Preview feature.

SingleStore Dashboard Apps enables users to create, publish, and manage real-time interactive dashboards through the Cloud Portal. It integrates with SingleStore Notebooks and uses Plotly's Dash framework. It helps in monitoring key metrics, exploring trends, and making data-driven decisions in real time.

Create and manage dashboard apps using the Cloud Portal.

## Publish Dashboard Apps using the Cloud Portal

## Create a Dashboard App

Dashboard Apps can be created for shared notebooks only. Create a dashboard app:

1. **Using Dashboards in the left navigation**

   ![Navigate to Container Services > Dashboards to publish a dashboard using a shared notebook.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt6418e0e5333dd661/6a44f1fd4774367f73d3cf34/Screenshot_2025-11-18_at_2_01_53_PM-eqpLx3.png)

2. **Using Shared Notebooks**

   1. Navigate to **Editor > Shared**.

   2. Select a shared notebook.

   3. Select **Publish** (on the top right).

   ![](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt409fe341aab5b205/6a44f25474bff7c616a0383c/Screenshot_2025-11-18_at_2_07_56_PM-yiK0hD.png)

## New Dashboard App

After selecting **Publish**, a new dialog box appears.

![Select Dashboard in Publish Settings dialog.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt18500995fad06073/6a44f239d8b87a66b1ac2292/appsetting-7kDqxj.png)

| **Publish Settings** |                                                                                                                                                                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Publish as**       | Select**Dashboard**.                                                                                                                                                                                                                             |
| **Name**             | Enter a name of the dashboard app.                                                                                                                                                                                                               |
| **Description**      | Enter the dashboard app description.                                                                                                                                                                                                             |
| **Notebook**         | Select a shared notebook to publish as a dashboard app. The shared notebook is pre-selected when the dashboard app is published through notebooks.                                                                                               |
| **Deployment**       | Select theSingleStoredeployment (workspace) the notebook connects to.Selecting aworkspaceallows connecting to theSingleStoredatabases referenced in the notebook natively. A dashboard app can be published without a deployment attached to it. |
| **Runtime**          | Select a runtime from the following:<ul> <li>Small</li> <li>Medium</li> <li>GPU-T4</li> </ul><blockquote> <p><strong>📝 Note</strong>: <p>This field is in preview.</p></p> </blockquote>                                                        |
| **Region**           | Select a region.                                                                                                                                                                                                                                 |
| **Idle Timeout**     | Select an idle timeout.<blockquote> <p><strong>📝 Note</strong>: <p>This field is in preview.</p></p> </blockquote>                                                                                                                              |

Select **Next**.

![View the summary of the dashboard app.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt1e8b767e611d0911/6a44f0bddc49d6ae9195cbde/Screenshot_2025-11-27_at_4_17_13_PM-QCxjym.png)

Select **Publish** to publish the notebook as a dashboard app.

## Example Notebook

The following notebook shows how to publish your first dashboard app.

## Manage an Existing Dashboard App

To view an existing dashboard app, select **Dashboards** in the left navigation. Existing dashboard App can be managed by performing the following actions:

* View
* Update
* Share
* Delete

## View an Existing Dashboard App

To view an existing dashboard app, select the dashboard app name under the **Name** column.

![View the pubished dashboard app in Apps.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt2e85189ee46cc2f4/6a44f2727f7a1a170bcec5ae/dashapp-3AFOOK.png)

View the following details for each dashboard app:

![View the dashboard after selecting the dashboard app name under Name column.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt0b27c9e1ba551df2/6a44f1ecf1de31017e7e3b83/dashboardview-Z4lnBe.png)

View the details of a dashboard app on the right navigation. Following actions can be performed for a dashboard app from this page:

* View Dashboard in New Tab
* View API Keys
* View Live Logs
* Share
* Update
* Delete

## View API Keys

Refer to [Container App API Keys](https://docs.singlestore.com/cloud/container-services/container-app-api-keys.md) for related information.

## View Live Logs

To view live logs of the selected dashboard app, select **View Live Logs** from the ellipsis on the right side. A new window appears, where the **Timestamp** and the message in the **Body** column can be viewed. View the **Log JSON** by selecting the eye icon.

## Update an Existing Dashboard App

To update an existing dashboard app, select the ellipsis in the **Actions** column of the dashboard app, and select **Update**.

![Update the details of dashboard in Dashboard settings.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blte63cf59a4189e003/6a44f1086ca2f70ec974816e/dashupdatesettings-1OZNb7.png)

A dashboard app can also be updated using the shared notebook.

![Select Update Dashboard in the upper right in the notebook to update the dashboard details.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt635669dd12122a32/6a44f10c58f84c0897389350/dashupdate-6RsSWK.png)

Select **Update Dashboard** and select **Update**.

## Share an Existing Dashboard App

To share an existing dashboard app, select the ellipsis in the **Actions** column of the dashboard app, and select **Share**

## Delete an Existing Dashboard App

To delete an existing dashboard app, select the ellipsis in the **Actions** column of the dashboard app, and select **Delete**.

## Status of Dashboard Apps

| **Status**   | **Description**                                                                                                                                                                        |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Initializing | The notebook is creating or updating the dashboard.                                                                                                                                    |
| Active       | The dashboard is configured correctly. The notebook is successfully published as a dashboard.                                                                                          |
| Failed       | The dashboard is not configured correctly. View the notebook snapshot to debug the failure.                                                                                            |
| Error        | An error unrelated to the notebook code prevented the dashboard from initializing. Refer to[Troubleshoot Dashboard Apps](https://docs.singlestore.com/#section-idm234663965101069.md). |

## Troubleshoot Dashboard Apps

SingleStore automatically saves a snapshot of the notebook for each execution that fails. Navigate to **Apps** in the left navigation, select the dashboard, and download the snapshot associated with the failed dashboard to diagnose the error.

| **Error**                    | **Solution**                                                                                                |
| ---------------------------- | ----------------------------------------------------------------------------------------------------------- |
| WorkspaceDeleted             | Update the dashboard and select a deployment.                                                               |
| WorkspaceSuspended           | Resume theworkspaceor create a new dashboard with a different deployment.                                   |
| Database Detached            | Reattach the database with the right permissions or create a new dashboard with a different database.       |
| Notebook Deleted/Not Present | Create a new dashboard with a different notebook.                                                           |
| Internal Errors/Misc         | Reach out to[SingleStoreSupport](http://support.singlestore.com)or use the chat feature in theCloud Portal. |

***

Modified at: February 24, 2026

Source: [/cloud/container-services/dashboard-apps/](https://docs.singlestore.com/cloud/container-services/dashboard-apps/)

(An index of the documentation is available at /llms.txt)