---
title: Deploy Grafana with AI on Blossom
url: "/deploy/grafana/"
canonical_url: https://docs.blossom88.com/deploy/grafana/
markdown_url: https://docs.blossom88.com/deploy/grafana.md
summary: Deploy Grafana with AI on Blossom. Build private dashboards on regular App
  Capacity, with users and dashboard settings in managed PostgreSQL.
categories:
- deployment
- analytics
---

# Deploy Grafana with AI on Blossom

[Grafana](https://grafana.com/oss/grafana/) turns data from your applications
and infrastructure into dashboards. Connect a data source, build panels, and
share the views your team needs.

It's written in Go and TypeScript with React. This setup uses managed
PostgreSQL for Grafana's users, dashboards, and data-source settings. The
metrics themselves come from your connected data sources. Browse the
[source on GitHub](https://github.com/grafana/grafana).

Grafana runs on regular App Capacity, using its bundled plugins.

[Install the Blossom CLI and skill](/learn/getting-started/install/)
on your agent's machine and choose a Blossom Cloud Location when you log in.
You can also use
[Blossom BYOC (bring your own cloud)](/learn/getting-started/choose-your-cloud/#blossom-byoc).

## Ask Your Agent

> **Ask your AI agent:** Deploy Grafana on Blossom with managed Postgres. Help me build a dashboard for my app.

> Follow this guide: https://docs.blossom88.com/deploy/grafana/



Your agent checks the current
[configuration requirements](https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/),
chooses a maintained image, and saves the deployment settings.

| Part | Purpose |
|---|---|
| Grafana Service | Dashboard editor, visualizations, and queries |
| Managed PostgreSQL | Users, dashboards, permissions, and data-source settings |
| Your data sources | The metrics or other data shown in panels |

Keep Grafana behind **Blossom Account access** and native Grafana sign-in.
Create the administrator privately, disable open sign-up, and keep Grafana's
security secret stable across updates.

## Build Your First Dashboard

> **Ask your AI agent:** Create a sample dashboard so I can learn the editor, then help me connect my own data source.

> Follow this guide: https://docs.blossom88.com/deploy/grafana/



Grafana's bundled
[TestData data source](https://grafana.com/docs/grafana/latest/datasources/testdata/)
generates synthetic data without another service. Use it to try the editor,
change a time range, and save your first panels.

![Grafana displaying two sample time-series panels generated by its bundled TestData data source.](/assets/images/guides/grafana/dashboard.png)

Connect your own data source for real metrics. Give viewers read access and
check their permissions before sharing editing access.

<details class="optional-reading" markdown="1">
<summary>Commands behind the deployment</summary>

Create a prebuilt-image Environment, connect PostgreSQL, and add the Service:

    blossom app:create --data app.yml
    blossom environment:create --data environment.yml
    blossom database_instance:create --data postgres.yml --follow
    blossom environment_link:create --data database-link.yml
    blossom env_var:push --environment environment-100 --file .env.production
    blossom service:create --data grafana-service.yml
    blossom environment:deploy --id environment-100 --follow

Set `GF_DATABASE_TYPE=postgres` and use the linked database URL for
`GF_DATABASE_URL`. Grafana expects the `postgres://` scheme; normalize a
`postgresql://` link without changing its credentials, database, or connection
options. Set `GF_SERVER_ROOT_URL` to the generated public URL before starting
Grafana through the image's supported entrypoint.

Use a strong initial `GF_SECURITY_ADMIN_PASSWORD`, a stable
`GF_SECURITY_SECRET_KEY`, and `GF_USERS_ALLOW_SIGN_UP=false`. Keep native sign-in
enabled. Use an HTTP health check against `/api/health` and allow startup time
for Grafana's database migrations.

This recipe uses bundled plugins and stores application records in PostgreSQL.
Declare additional plugins and provisioning files in your deployment
configuration so replacement Containers can recreate them.

</details>

## Keep Your Dashboards Through Updates

> **Ask your AI agent:** Update Grafana and check that my dashboards, data sources, and users still work.

> Follow this guide: https://docs.blossom88.com/deploy/grafana/



Preserve PostgreSQL and the security secret. Sign in again after replacement,
find a saved dashboard through dashboard search, and refresh its panels.
Save a small edit to confirm that the new Container can still write settings.

This guide tests one Grafana instance. Configure alerting and any additional
instances for your workload before relying on them.

## What You Get

- A private Grafana dashboard editor and viewer
- Users, dashboards, and data-source settings in managed PostgreSQL
- Regular App Capacity with bundled plugins
- Saved dashboards that survive application Container replacement
