Install on macOS
This page explains how to install Grafana and get the service running on your macOS.
Note on upgrading: While the process for upgrading Grafana is very similar to installing Grafana, there are some key backup steps you should perform. Before you perform an upgrade, read Upgrading Grafana for tips and guidance on updating an existing installation.
Install with Homebrew
Use Homebrew to install the most recent released version of Grafana using Homebrew package.
On the Homebrew homepage, search for Grafana. The last stable and released version is listed.
Open a terminal and enter:
brew update brew install grafana
The brew page downloads and untars the files into
Start Grafana using the command:
brew services start grafana
Install standalone macOS binaries
To install a nightly build, or to install the latest version of Grafana without Homebrew, go to the Grafana download page.
Select the Grafana version you want to install. By default, the most recent released version is selected.
Note: The downloads page lists only finished releases. If you want to install a beta version, click [Nightly ] Nightly Builds and then select a version.
Select an Edition.
- Open Source - Functionally identical to the enterprise version, but you will need to download the enterprise version if you want enterprise features.
- Enterprise - Recommended download. Functionally identical to the open source version, but includes features you can unlock with a license if you so choose.
Open a terminal and download the binary using the cURL command. The following example shows Grafana 7.1.5 version:
curl -O https://dl.grafana.com/oss/release/grafana-7.1.5.darwin-amd64.tar.gz
Untar the gz file and copy the files to the location of your preference.
To start Grafana service, go to the directory and run the command:
Refer to the Getting Started guide for information about logging in, setting up data sources, and so on. Also, refer to the Configuration page for details on options for customizing your environment, logging, database, and so on.
To upgrade Grafana, use the reinstall command:
brew update brew reinstall grafana
Related Grafana resources
GrafanaCONline 2021 is coming June 7-17
Be the first to learn about exciting next-generation features in Grafana 8.0, be inspired by what community members are building, and attend expert-led sessions and workshops on Grafana, Prometheus, Loki logs, and more.
Unify your data with Grafana plugins: Splunk, MongoDB, Datadog, and more
Show how Grafana can be used to take data from multiple different sources and unify it, without disrupting the investments that are working today.
Demo: Getting started with Grafana Enterprise and observability
Join the Grafana Labs team for a 30-minute demo of how to get started with the Grafana Stack, so you can go from zero to observability in just a few minutes.