# Grafana app

Embed a live Grafana dashboard on your display — metrics, graphs, and tables that update automatically.

## Creating a Grafana app

1. Go to **Content > New > App** and search for the **Grafana** app.
2. Click the app to start creating a new app.
3. Enter an **app name**.
4. Paste the **Dashboard URL** — the full URL of the Grafana dashboard you want to show.
5. Enter the **Grafana username** and **password** — a dedicated signage account is safer than a personal one.
6. Pick a **Refresh interval** and an optional time range (e.g. `now-1d` to `now`).
7. Click **Create app**.

::: tip Use a read-only user
Create a separate Grafana user with view-only access to just the dashboard you want to show. This way the signage credentials can't modify anything, and if a display is compromised the blast radius stays small.
:::

::: info Self-hosted Grafana?
The Grafana instance must be reachable from the internet for the player to load it. If your Grafana is internal, either expose the dashboard with a reverse proxy + auth, or use a kiosk URL token instead of username/password.
:::

## All configuration options

| Setting | Explanation | Required |
|---|---|---|
| App name | A recognizable name shown in your content library | **Yes** |
| Dashboard URL | Full URL of the Grafana dashboard | **Yes** |
| Grafana username | Account used to sign in | **Yes** |
| Grafana password | Password for that account | **Yes** |
| Refresh interval | 1, 3, 5, 10, or 30 minutes, or 1 hour | **Yes** |
| From / to | Grafana time range (e.g. `now-1d`, `now`) | No |
| Auto fit panels | Scale panels to fit the display | No |
| Timezone | Override the browser-default timezone | No |