Menu

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.

Enterprise Open source

Install on macOS

This page provides instructions to help you install Grafana on 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. Read Upgrading Grafana for tips and guidance on updating an existing installation.

1. Download and install

Before you begin, you must have Homebrew installed.

  1. On 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 finished releases. If you want to install a beta version, click Nightly Builds and then select a version.
  2. 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.
  3. Click Mac.

  4. Copy and paste the code from the installation page into your command line and run. It follows the pattern shown below.

    bash
    brew update
    brew install grafana

2. Start Grafana

Start Grafana using Homebrew services:

bash
brew services start grafana

Upgrade with Homebrew

To upgrade Grafana, use the reinstall command:

bash
brew update
brew reinstall grafana