Files
Christopher Moyer d67ad9efc4 docs: updates windows/mac install topics (#64740)
* updates windows/mac install topics

* corrects typo

* Apply suggestions from code review

Co-authored-by: Dan Cech <dcech@grafana.com>

* tweaks

---------

Co-authored-by: Dan Cech <dcech@grafana.com>
2023-03-21 10:24:19 -05:00

2.3 KiB

aliases description title menuTitle weight
../../installation/mac/
How to install Grafana OSS or Enterprise on macOS Install Grafana on macOS macOS 600

Install Grafana on macOS

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:

  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:

    brew services start grafana
    

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 installation 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:

    ./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]({{< relref "../../../upgrade-guide/" >}}) for guidance on updating an existing installation.

Next steps

  • [Start the Grafana server]({{< relref "../../start-restart-grafana/" >}})