ContextQMD
Back to Grafana

Install Grafana on macOS

docs/sources/setup-grafana/installation/mac/index.md

13.0.13.1 KB
Original Source

Install Grafana on macOS

This page explains how to install Grafana on macOS.

The following video demonstrates how to install Grafana on macOS as outlined in this document:

{{< youtube id="1zdm8SxOLYQ" >}}

Install Grafana on macOS using Homebrew

To install Grafana on macOS using Homebrew, complete the following steps:

  1. On the Homebrew homepage, search for Grafana.

    The last stable and released version is listed.

  2. Open a terminal and run the following commands:

    brew update
brew install grafana

    The brew page downloads and untars the files into:

    • /usr/local/Cellar/grafana/[version] (Intel Silicon)
    • /opt/homebrew/Cellar/grafana/[version] (Apple Silicon)

  3. To start Grafana, run the following command:

    bash
    brew services start grafana

Using the Grafana CLI with Homebrew

To use the Grafana CLI with Homebrew, you need to append the home path, the config file path and - based on the command - some other configurations to the cli command:

For admin commands, you need to append the --configOverrides cfg:default.paths.data=/opt/homebrew/var/lib/grafana configuration. Example:

bash
/opt/homebrew/opt/grafana/bin/grafana cli --config /opt/homebrew/etc/grafana/grafana.ini --homepath /opt/homebrew/opt/grafana/share/grafana --configOverrides cfg:default.paths.data=/opt/homebrew/var/lib/grafana admin reset-admin-password <new password>

For plugins commands, you need to append the --pluginsDir /opt/homebrew/var/lib/grafana/plugins configuration. Example:

bash
/opt/homebrew/opt/grafana/bin/grafana cli --config /opt/homebrew/etc/grafana/grafana.ini --homepath /opt/homebrew/opt/grafana/share/grafana --pluginsDir "/opt/homebrew/var/lib/grafana/plugins" plugins install <plugin-id>

Install standalone macOS binaries

To install Grafana on macOS using the standalone binaries, complete the following steps:

  1. Navigate to the Grafana download page.

  2. Select the Grafana version you want to install.

    • The most recent Grafana version is selected by default.
    • The Version field displays only tagged releases. If you want to install a nightly build, click Nightly Builds and then select a version.

  3. Select an Edition.

    • Enterprise: This is the recommended version. It is functionally identical to the open source version, but includes features you can unlock with a license, if you so choose.
    • Open Source: This version is functionally identical to the Enterprise version, but you will need to download the Enterprise version if you want Enterprise features.

  4. Click Mac.

  5. Copy and paste the code from the download page into your command line and run.

  6. Untar the gz file and copy the files to the location of your preference.

  7. To start Grafana service, go to the directory and run the command:

    bash
    ./bin/grafana server

Alternatively, watch the Grafana for Beginners video below:

{{< youtube id="T51Qa7eE3W8" >}}

Next steps