@@ -19,22 +19,26 @@ Grafana has a number of configuration options that you can specify in a `.ini` c
## Config file locations
*Do not* change `defaults.ini`! Grafana defaults are stored in this file. Depending on your OS, make all configuration changes in either `custom.ini` or `grafana.ini`.
_Do not_ change `defaults.ini`! Grafana defaults are stored in this file. Depending on your OS, make all configuration changes in either `custom.ini` or `grafana.ini`.
- Default configuration from `$WORKING_DIR/conf/defaults.ini`
- Custom configuration from `$WORKING_DIR/conf/custom.ini`
- The custom configuration file path can be overridden using the `--config` parameter
### Linux
If you installed Grafana using the `deb` or `rpm` packages, then your configuration file is located at `/etc/grafana/grafana.ini` and a separate `custom.ini` is not used. This path is specified in the Grafana init.d script using `--config` file parameter.
### Docker
Refer to [Configure a Grafana Docker image]({{<relref"../installation/configure-docker.md">}}) for information about environmental variables, persistent storage, and building custom Docker images.
### Windows
`sample.ini` is in the same directory as `defaults.ini` and contains all the settings commented out. Copy `sample.ini` and name it `custom.ini`.
### MacOS
By default, the configuration file is located at `/usr/local/etc/grafana/grafana.ini`. To configure Grafana, add a configuration file named `custom.ini` to the `conf` folder to override any of the settings defined in `conf/defaults.ini`.
## Comments in .ini Files
...
...
@@ -42,6 +46,7 @@ By default, the configuration file is located at `/usr/local/etc/grafana/grafana
Semicolons (the `;` char) are the standard way to comment out lines in a `.ini` file. If you want to change a setting, you must delete the semicolon (`;`) in front of the setting before it will work.
**Example**
```
# The HTTP port to use
;http_port = 3000
...
...
@@ -272,8 +277,7 @@ Either `mysql`, `postgres` or `sqlite3`, it's your choice.
### host
Only applicable to MySQL or Postgres. Includes IP or hostname and port or in case of Unix sockets the path to it.
For example, for MySQL running on the same host as Grafana: `host =
127.0.0.1:3306` or with Unix sockets: `host = /var/run/mysqld/mysqld.sock`
For example, for MySQL running on the same host as Grafana: `host = 127.0.0.1:3306` or with Unix sockets: `host = /var/run/mysqld/mysqld.sock`
### name
...
...
@@ -294,9 +298,11 @@ Use either URL or the other fields below to configure the database
Example: `mysql://user:secret@host:port/database`
### max_idle_conn
The maximum number of connections in the idle connection pool.
### max_open_conn
The maximum number of open connections to the database.
### conn_max_lifetime
...
...
@@ -401,7 +407,7 @@ Set to false to disable all checks to https://grafana.com for new versions of in
### google_analytics_ua_id
If you want to track Grafana usage via Google analytics specify *your* Universal
If you want to track Grafana usage via Google analytics specify _your_ Universal
Analytics ID here. By default this feature is disabled.
### google_tag_manager_id
...
...
@@ -451,7 +457,7 @@ Set to `true` if you host Grafana behind HTTPS. Default is `false`.
### cookie_samesite
Sets the `SameSite` cookie attribute and prevents the browser from sending this cookie along with cross-site requests. The main goal is to mitigate the risk of cross-origin information leakage. This setting also provides some protection against cross-site request forgery attacks (CSRF), [read more about SameSite here](https://www.owasp.org/index.php/SameSite). Valid values are `lax`, `strict`, `none`, and `disabled`. Default is `lax`. Using value `disabled` does not add any `SameSite` attribute to cookies.
Sets the `SameSite` cookie attribute and prevents the browser from sending this cookie along with cross-site requests. The main goal is to mitigate the risk of cross-origin information leakage. This setting also provides some protection against cross-site request forgery attacks (CSRF), [read more about SameSite here](https://www.owasp.org/index.php/SameSite). Valid values are `lax`, `strict`, `none`, and `disabled`. Default is `lax`. Using value `disabled` does not add any `SameSite` attribute to cookies.
### allow_embedding
...
...
@@ -461,7 +467,7 @@ mitigate the risk of [Clickjacking](https://www.owasp.org/index.php/Clickjacking
### strict_transport_security
Set to `true` if you want to enable HTTP `Strict-Transport-Security` (HSTS) response header. This is only sent when HTTPS is enabled in this configuration. HSTS tells browsers that the site should only be accessed using HTTPS. The default value is `false` until the next minor release, `6.3`.
Set to `true` if you want to enable HTTP `Strict-Transport-Security` (HSTS) response header. This is only sent when HTTPS is enabled in this configuration. HSTS tells browsers that the site should only be accessed using HTTPS.
### strict_transport_security_max_age_seconds
...
...
@@ -529,7 +535,7 @@ The interval string is a possibly signed sequence of decimal numbers, followed b
### allow_sign_up
Set to `false` to prohibit users from being able to sign up / create
user accounts. Default is `false`. The admin user can still create
user accounts. Default is `false`. The admin user can still create
users from the [Grafana Admin Pages](/reference/admin).
### allow_org_create
...
...
@@ -552,7 +558,7 @@ that this organization already exists. Default is 1.
### auto_assign_org_role
The role new users will be assigned for the main organization (if the
above setting is set to true). Defaults to `Viewer`, other valid
above setting is set to true). Defaults to `Viewer`, other valid
options are `Admin` and `Editor`. e.g.:
`auto_assign_org_role = Viewer`
...
...
@@ -575,7 +581,7 @@ Set the default UI theme: `dark` or `light`. Default is `dark`.
### External user management
If you manage users externally you can replace the user invite button for organizations with a link to an external site together with a description.
If you manage users externally you can replace the user invite button for organizations with a link to an external site together with a description.
### viewers_can_edit
...
...
@@ -721,7 +727,7 @@ Email server settings.
Enable this to allow Grafana to send email. Default is `false`.
If the password contains `#` or `;`, then you have to wrap it with triple quotes. Example: """#password;"""
If the password contains `#` or `;`, then you have to wrap it with triple quotes. Example: """#password;"""
### host
...
...
@@ -771,7 +777,7 @@ Either "OpportunisticStartTLS", "MandatoryStartTLS", "NoStartTLS". Default is `e
Default is `false`.
### templates_pattern
### templates_pattern
Default is `emails/*.html`.
...
...
@@ -1113,6 +1119,7 @@ of the default, which is virtual hosted bucket addressing when possible (`http:/
(for backward compatibility, only works when no bucket or region are configured)
Bucket URL for S3. AWS region can be specified within URL or defaults to 'us-east-1', e.g.
Optional URL to send to users in notifications. If the string contains the sequence ${file}, it is replaced with the uploaded filename. Otherwise, the file name is appended to the path part of the URL, leaving any query string unchanged.
Optional URL to send to users in notifications. If the string contains the sequence \${file}, it is replaced with the uploaded filename. Otherwise, the file name is appended to the path part of the URL, leaving any query string unchanged.
<hr>
...
...
@@ -1249,7 +1256,7 @@ Instruct headless browser instance to use a default timezone when not provided b
### rendering_language
Instruct headless browser instance to use a default language when not provided by Grafana, e.g. when rendering panel image of alert.
Refer to the HTTP header Accept-Language to understand how to format this value, e.g. 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5'.
Refer to the HTTP header Accept-Language to understand how to format this value, e.g. 'fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, \*;q=0.5'.
### rendering_viewport_device_scale_factor
...
...
@@ -1262,7 +1269,7 @@ Instruct headless browser instance whether to ignore HTTPS errors during navigat
### rendering_verbose_logging
Instruct headless browser instance whether to capture and log verbose information when rendering an image. Default is `false` and will only capture and log error messages.
Instruct headless browser instance whether to capture and log verbose information when rendering an image. Default is `false` and will only capture and log error messages.
When enabled, debug messages are captured and logged as well.