IntenseWebs/grafana
3
0
Fork 0
mirror of https://github.com/grafana/grafana.git synced 2025-02-25 18:55:37 -06:00
Code Issues Packages Projects Releases Wiki Activity

Mac os install changes (#27779)

Browse Source 
* Reorganized topic. Added section on how to install Grafana using standalone binary files.

* Added next steps section.

* Updated list numbering.
This commit is contained in:
achatterjee-grafana 2020-09-25 19:55:53 -04:00 committed by GitHub
parent 552e4cb84d
commit c73d7db092
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 44 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

64
docs/sources/installation/mac.md
View File

@ -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: