2.3 KiB

Raw Blame History

grafana.ini configuration

Reference for grafana.ini server-side settings.

Server + database
Alerting
SMTP
Auth (OAuth example)
Security
Feature toggles

Server + database

[server]
http_port = 3000
domain = grafana.example.com
root_url = https://grafana.example.com/

[database]
type = postgres
host = postgres:5432
name = grafana
user = grafana
password = secret

After changing these, restart Grafana and verify:

curl http://localhost:3000/api/health returns {"database": "ok", ...}
curl http://localhost:3000/api/admin/settings | jq '.database' shows the new config

Alerting

[alerting]
enabled = true

[unified_alerting]
enabled = true

SMTP

[smtp]
enabled = true
host = smtp.gmail.com:587
user = alerts@example.com
password = yourpassword
from_address = alerts@example.com

Verify by sending a test email via the Alerting → Contact points UI.

Auth (OAuth example)

[auth.generic_oauth]
enabled = true
name = Okta
client_id = your_client_id
client_secret = your_secret
auth_url = https://your-org.okta.com/oauth2/v1/authorize
token_url = https://your-org.okta.com/oauth2/v1/token
api_url = https://your-org.okta.com/oauth2/v1/userinfo
scopes = openid profile email groups

For SAML and GitHub OAuth, see the grafana-cloud/admin skill. The configs are the same in OSS.

Security

[security]
admin_user = admin
admin_password = secret
allow_embedding = true       # required for embedding dashboards in iframes

admin_password is only consulted on first startup. To change later, use grafana-cli admin reset-admin-password <new-password>.

Feature toggles

[feature_toggles]
enable = publicDashboards

Multiple toggles are space-separated:

enable = publicDashboards correlations grafanaApiServer

Common problems

grafana.ini changes need a restart — config is read at startup, not live-reloaded
root_url matters for OAuth callbacks — if you set domain but not root_url, OAuth redirect URIs may not match
Sections are global — [server], [database], etc. apply at the process level, not per-org

2.3 KiB Raw Blame History