grafana/docs/sources/installation/mac.md

+++
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
```