grafana/docs/sources/installation/mac.md
Diana Payton 131610e8f7
Update mac.md (#22280)
Minor link update
2020-02-18 13:23:07 -08:00

51 lines
1.7 KiB
Markdown
Executable File

+++
title = "Install on macOS"
description = "Installing Grafana on macOS"
keywords = ["grafana", "configuration", "documentation", "mac", "homebrew", "osx"]
type = "docs"
[menu.docs]
parent = "installation"
weight = 500
+++
# 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]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing installation.
## 1. Download and install
Before you begin, you must have [Homebrew](http://brew.sh/) installed.
1. On the [Grafana download page](https://grafana.com/grafana/download?platform=mac), 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** - Not currently available for Mac.
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
```