Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Set up

Install Grafana

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.

Install Grafana on macOS using Homebrew

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

On the Homebrew homepage, search for Grafana.
The last stable and released version is listed.
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)
To start Grafana, run the following command:
bash
```
brew services start grafana
```

Install standalone macOS binaries

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

Navigate to the Grafana download page.
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.
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.
Click Mac.
Copy and paste the code from the download page into your command line and run.
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:
bash
```
./bin/grafana-server
```

Upgrade Grafana

While the process for upgrading Grafana is very similar to installing Grafana, there are important backup tasks you should perform. Refer to Upgrade Grafana for guidance on updating an existing installation.