grafana/docs/sources/upgrade-guide/upgrade-v10.0/index.md

description	keywords	labels	menutitle	title	weight
Upgrade to Grafana v10.0	grafana configuration documentation upgrade	products enterprise oss	Upgrade to v10.0	Upgrade to Grafana v10.0	1700

Upgrade to Grafana v10.0

{{< docs/shared lookup="upgrade/intro.md" source="grafana" version="" >}}

{{< docs/shared lookup="back-up/back-up-grafana.md" source="grafana" version="" leveloffset="+1" >}}

{{< docs/shared lookup="upgrade/upgrade-common-tasks.md" source="grafana" version="" >}}

Technical notes

Role-based access control changes

Role-based access control (RBAC) is now always enabled and we've removed the option to disable it.

No action is required.

However, if you decide to downgrade for any reason and disable RBAC, you'll need to run through the following guide before upgrading again.

The aforementioned sequence of actions (upgrade, downgrade, disable RBAC, upgrade again) causes legacy access control and role-based access control systems to be out of sync. As a side effect, permissions for some Grafana resources, like dashboards, might be lost. To prevent that from happening, before you upgrade Grafana back again, please take the following steps:

1. Stop Grafana.
2. In your database, run the following SQL queries:

DELETE
FROM builtin_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM team_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM user_role
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM permission
where role_id IN (SELECT id
                  FROM role
                  WHERE name LIKE 'managed:%');

DELETE
FROM role
WHERE name LIKE 'managed:%';

DELETE
FROM migration_log
WHERE migration_id IN ('teams permissions migration',
                       'dashboard permissions',
                       'dashboard permissions uid scopes',
                       'data source permissions',
                       'data source uid permissions',
                       'managed permissions migration',
                       'managed folder permissions alert actions repeated migration',
                       'managed permissions migration enterprise');

3. Start Grafana again.

Case-insensitive usernames and email addresses

Usernames and email addresses are now treated as case-insensitive in Grafana. If you're not using MySQL as a database, potential user identity conflicts may arise when users try to log in. We recommend you resolve any potential conflicts in advance by using the Grafana CLI tool for managing user conflicts.

Dashboard previews removal

We've removed the Dashboard previews feature introduced behind a feature flag in Grafana version 9.0.

No action is required.

The dashboardPreviews feature flag is no longer available and can be safely removed from the Grafana server configuration.