Files
2020-09-15 13:44:31 -04:00

51 lines
1.8 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** - 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
```