Files
Diana Payton e64b5fd018 Docs: Update mac.md (#20782)
* Update mac.md

Reviewed and edited macOS install instructions.

* Updated mac.md and configuration.md

Removed developer build instructions from mac.md and moved configuration information from mac.md to configuration.md.

* Update mac.md

Updated to reflect the new fields on the Downloads page

* Update mac.md

* Update mac.md
2020-01-16 13:29:20 -08:00

51 lines
1.6 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), 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
```