Files
grafana/docs/sources/administration/preferences/change-home-dashboard.md
Christopher Moyer a568d421f8 Docs: Setup refactor (#49739)
* builds out refactored setup topics

* Automatically fix some relrefs with mv-manager

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Use refs for tutorials content which is outside of this repository

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Manually fix complicated relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* consolidates team sync and db encryption topics

* Fix relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* updates setup index file

* Convert TOML to YAML

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Add current alias for new alerting content

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Add current aliases to new setup-grafana and configure-security pages

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Update docs/sources/setup-grafana/configure-grafana/_index.md

Co-authored-by: Torkel Ödegaard <torkel@grafana.com>

* moves saml docs, updates order in TOC

* Manually fix relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* added usage insights topics, adjusted weights

* corrected relrefs

* Fix relrefs broken in rebase

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Torkel Ödegaard <torkel@grafana.com>
2022-06-02 11:57:22 -05:00

3.3 KiB

aliases description keywords title weight
/docs/grafana/latest/administration/change-home-dashboard/
/docs/grafana/latest/administration/preferences/change-home-dashboard/
How to replace the default home dashboard
grafana
configuration
documentation
home
Change home dashboard 300

Change the default home dashboard

The home dashboard you set is the one all users will see by default when they log in. You can set the home dashboard for the server, an organization, a team, or your personal user account. This topic provides instructions for each task.

{{< docs/shared "preferences/some-tasks-require-permissions.md" >}}

Navigate to the home dashboard

The home dashboard is the first dashboard a user sees when they sign in to Grafana. You can also navigate to the home dashboard manually.

  1. Hover your cursor over the Dashboards (four squares) icon.
  2. Click Home.

Set the home dashboard for the server

Users with the Grafana Server Admin flag on their account or access to the configuration file can define a JSON file to use as the home dashboard for all users on the server.

[Optional] Convert an existing dashboard into a JSON file

  1. Navigate to the page of the dashboard you want to use as the home dashboard.
  2. Click the Share dashboard icon next to the dashboard title.
  3. In the Export tab, click Save to file. Grafana converts the dashboard to a JSON file and saves it locally.

Use a JSON file as the home dashboard

  1. Save your JSON file somewhere that Grafana can access it. For example, in the Grafana data folder of Grafana.
  2. Update your configuration file to set the path to the JSON file. Refer to [default_home_dashboard_path]({{< relref "../../setup-grafana/configure-grafana/#default_home_dashboard_path" >}}) for more information about modifying the Grafana configuration files.
[dashboards]
# Path to the default home dashboard. If this value is empty, then Grafana uses StaticRootPath + "dashboards/home.json"
default_home_dashboard_path = data/main-dashboard.json

Note: On Linux, Grafana uses /usr/share/grafana/public/dashboards/home.json as the default home dashboard location.

Set the home dashboard for your organization

Organization administrators can choose a home dashboard for their organization.

{{< docs/list >}} {{< docs/shared "preferences/navigate-to-the-dashboard-list.md" >}} {{< docs/shared "preferences/org-preferences-list.md" >}} {{< docs/shared "preferences/select-home-dashboard-list.md" >}} {{< /docs/list >}}

Set home dashboard for your team

Organization administrators and Team Admins can choose a home dashboard for a team.

{{< docs/list >}} {{< docs/shared "preferences/navigate-to-the-dashboard-list.md" >}} {{< docs/shared "manage-users/view-team-list.md" >}}

  1. Click on the team that you want to change the home dashboard for and then navigate to the Settings tab. {{< docs/shared "preferences/select-home-dashboard-list.md" >}} {{< /docs/list >}}

Set your personal home dashboard

You can choose your own personal home dashboard. This setting overrides all home dashboards set at higher levels.

{{< docs/list >}} {{< docs/shared "preferences/navigate-to-the-dashboard-list.md" >}} {{< docs/shared "preferences/navigate-user-preferences-list.md" >}} {{< docs/shared "preferences/select-home-dashboard-list.md" >}} {{< /docs/list >}}