Grafana
This service deploys Grafana, an open-source analytics and monitoring platform for visualizing metrics from various data sources.
Services
grafana: The Grafana web interface and API server.
Environment Variables
| Variable Name | Description | Default Value |
|---|---|---|
| GRAFANA_VERSION | Grafana image version | 12.1.1 |
| GRAFANA_PORT_OVERRIDE | Host port mapping (maps to Grafana port 3000 in container) | 3000 |
| GRAFANA_ADMIN_USER | Admin username | admin |
| GRAFANA_ADMIN_PASSWORD | Admin password | admin |
| GRAFANA_ALLOW_SIGN_UP | Allow users to sign up themselves | false |
| GRAFANA_PLUGINS | Comma-separated list of plugins to install | "" |
| GRAFANA_ROOT_URL | Root URL for Grafana (used for links and redirects) | http://localhost:3000 |
| GRAFANA_SECRET_KEY | Secret key for signing cookies and encrypting database | "" |
Please modify the .env file as needed for your use case.
Volumes
grafana_data: A volume for storing Grafana's database and configuration.grafana_logs: A volume for storing Grafana logs.grafana.ini: Optional custom configuration file (mount to/etc/grafana/grafana.ini).provisioning: Optional directory for provisioning datasources and dashboards (mount to/etc/grafana/provisioning).
Default Credentials
- Username:
admin(configurable viaGRAFANA_ADMIN_USER) - Password:
admin(configurable viaGRAFANA_ADMIN_PASSWORD)
Security Notes
- Change the default admin password in production environments.
- Set a strong
GRAFANA_SECRET_KEYfor production use. - Consider disabling sign-up (
GRAFANA_ALLOW_SIGN_UP=false) in production. - Use HTTPS in production by configuring a reverse proxy or Grafana's TLS settings.
Common Use Cases
Installing Plugins
Set the GRAFANA_PLUGINS environment variable with a comma-separated list of plugin IDs:
GRAFANA_PLUGINS=grafana-clock-panel,grafana-simple-json-datasource
Custom Configuration
Mount a custom grafana.ini file to /etc/grafana/grafana.ini:
volumes:
- ./grafana.ini:/etc/grafana/grafana.ini
Provisioning Datasources and Dashboards
Mount a provisioning directory with datasource and dashboard configurations:
volumes:
- ./provisioning:/etc/grafana/provisioning
License
Grafana is licensed under the AGPL v3.0 license. Commercial licenses are available from Grafana Labs.