diff --git a/docs/sources/installation/mac.md b/docs/sources/installation/mac.md index 56e6134d03a..bb14a9db839 100755 --- a/docs/sources/installation/mac.md +++ b/docs/sources/installation/mac.md @@ -10,37 +10,61 @@ weight = 500 # Install on macOS -This page provides instructions to help you install Grafana on macOS. +This page explains how to install Grafana and get the service running on your macOS. It has the following topics: + - [Install with Homebrew](#install-with-homebrew) + - [Install standalone macOS binaries](#install-standalone-macos-binaries) + - [Next steps](#next-steps) + - [Upgrade](#upgrade) -**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. +**Note on upgrading:** While the process for upgrading Grafana is very similar to installing Grafana, there are some key backup steps you should perform. Before you perform an upgrade, read [Upgrading Grafana]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing installation. -## 1. Download and install +## Install with Homebrew -Before you begin, you must have [Homebrew](http://brew.sh/) installed. +Use [Homebrew](http://brew.sh/) to install the most recent released version of Grafana using Homebrew package. -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 +1. On the Homberew homepage, search for Grafana. The last stable and released version is listed. +1. Open a terminal and enter: + ``` brew update brew install grafana ``` -## 2. Start Grafana + The brew page downloads and untars the files into `/usr/local/Cellar/grafana/version`. -Start Grafana using Homebrew services: +1. Start Grafana using the command: + ```bash + brew services start grafana + ``` -```bash -brew services start grafana -``` +## Install standalone macOS binaries -## Upgrade with Homebrew +To install a nightly build, or to install the latest version of Grafana without Homebrew, go to the [Grafana download page](https://grafana.com/grafana/download/7.3.0-381ff45epre?platform=mac). + +1. Select the Grafana version you want to install. By default, the most recent released version is selected. + + > **Note:** The downloads page lists only finished releases. If you want to install a beta version, click [Nightly ] **Nightly Builds** and then select a version. + +1. 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. +1. Click **Mac**. +1. Open a terminal and download the binary using the cURL command. The following example shows Grafana 7.1.5 version: + ```bash + curl -O https://dl.grafana.com/oss/release/grafana-7.1.5.darwin-amd64.tar.gz + ``` +1. Untar the gz file and copy the files to the location of your preference. +1. To start Grafana service, go to the directory and run the command: + ```bash + ./bin/grafana-server web + ``` + +## Next steps + +Refer to the [Getting Started]({{< relref "../getting-started/getting-started/" >}}) guide for information about logging in, setting up data sources, and so on. Also, refer to the [Configuration]({{< relref "../administration/configuration.md" >}}) page for details on options for customizing your environment, logging, database, and so on. + +## Upgrade + +**Using Homebrew** To upgrade Grafana, use the reinstall command: