Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Set upbreadcrumb arrow Install Grafanabreadcrumb arrow macOS
Enterprise Open source

Install Grafana on macOS

You can use Grafana Cloud to avoid installing, maintaining, and scaling your own instance of Grafana. Create a free account to get started, which includes free forever access to 10k metrics, 50GB logs, 50GB traces, 500VUh k6 testing & more.

This page explains how to install Grafana on macOS.

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

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:

Next steps