mirror of
https://github.com/grafana/grafana.git
synced 2025-02-11 16:15:42 -06:00
78996516af
* Update configuration.md * moved configuration.md to administration folder * updated links * Added quota section * Update upgrading.md * Update configuration.md * Update configuration.md * Update configuration.md * Updating links * Update configuration.md * Update configuration.md * Update configuration.md Reworked the security options * Update configuration.md * Update configuration.md * Update provisioning.md * Update provisioning.md * Update configuration.md * Update configuration.md * Update docs/sources/administration/configuration.md Co-authored-by: Marcus Efraimsson <marcus.efraimsson@gmail.com> Co-authored-by: Marcus Efraimsson <marcus.efraimsson@gmail.com>
90 lines
3.0 KiB
Markdown
90 lines
3.0 KiB
Markdown
+++
|
|
title = "White-labeling"
|
|
description = "White-labeling"
|
|
keywords = ["grafana", "white-labeling", "enterprise"]
|
|
aliases = ["/docs/grafana/latest/enterprise/white-labeling/"]
|
|
type = "docs"
|
|
[menu.docs]
|
|
name = "White-labeling"
|
|
parent = "enterprise"
|
|
weight = 700
|
|
+++
|
|
|
|
# White labeling
|
|
|
|
White labeling allows you to replace the Grafana brand and logo with your own corporate brand and logo.
|
|
|
|
> Only available in Grafana Enterprise v6.6+.
|
|
|
|
Grafana Enterprise has white labeling options in the `grafana.ini` file. As with all configuration options, you can also set them with environment variables.
|
|
|
|
You can change the following elements:
|
|
|
|
- Application title
|
|
- Login background
|
|
- Login logo
|
|
- Side menu top logo
|
|
- Footer and help menu links
|
|
- Fav icon (shown in browser tab)
|
|
- Login title (will not appear if a login logo is set, Grafana v7.0+)
|
|
- Login subtitle (will not appear if a login logo is set, Grafana v7.0+)
|
|
- Login box background (Grafana v7.0+)
|
|
|
|
> You will have to host your logo and other images used by the white labeling feature separately. Make sure Grafana can access the URL where the assets are stored.
|
|
|
|
{{< docs-imagebox img="/img/docs/v66/whitelabeling_1.png" max-width="800px" caption="White labeling example" >}}
|
|
|
|
The configuration file in Grafana Enterprise contains the following options. Each option is defined in the file. For more information about configuring Grafana, refer to [Configuration]({{< relref "../administration/configuration.md">}}).
|
|
|
|
```ini
|
|
# Enterprise only
|
|
[white_labeling]
|
|
# Set to your company name to override application title
|
|
;app_title =
|
|
|
|
# Set to main title on the login page (Will not appear if a login logo is set)
|
|
;login_title =
|
|
|
|
# Set to login subtitle (Will not appear if a login logo is set)
|
|
;login_subtitle =
|
|
|
|
# Set to complete URL to override login logo
|
|
;login_logo =
|
|
|
|
# Set to complete CSS background expression to override login background
|
|
# example: login_background = url(http://www.bhmpics.com/wallpapers/starfield-1920x1080.jpg)
|
|
;login_background =
|
|
|
|
# Set to complete CSS background expression to override login box background
|
|
;login_box_background =
|
|
|
|
# Set to complete URL to override menu logo
|
|
;menu_logo =
|
|
|
|
# Set to complete URL to override fav icon (icon shown in browser tab)
|
|
;fav_icon =
|
|
|
|
# Set to complete URL to override apple/ios icon
|
|
;apple_touch_icon =
|
|
```
|
|
|
|
Below is an example for how to replace the default footer and help links with two custom links.
|
|
|
|
```ini
|
|
footer_links = support guides
|
|
footer_links_support_text = Support
|
|
footer_links_support_url = http://your.support.site
|
|
footer_links_guides_text = Guides
|
|
footer_links_guides_url = http://your.guides.site
|
|
```
|
|
|
|
Here is the same example using environment variables instead of the custom.ini or grafana.ini file.
|
|
|
|
```
|
|
GF_WHITE_LABELING_FOOTER_LINKS=support guides
|
|
GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_TEXT=Support
|
|
GF_WHITE_LABELING_FOOTER_LINKS_SUPPORT_URL=http://your.support.site
|
|
GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_TEXT=Guides
|
|
GF_WHITE_LABELING_FOOTER_LINKS_GUIDES_URL=http://your.guides.site
|
|
```
|