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

Docs: Update mac.md (#20782)

Browse Source 
* 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
This commit is contained in:
Diana Payton 2020-01-16 13:29:20 -08:00 committed by GitHub
parent 0f0374544f
commit e64b5fd018
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 27 additions and 58 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
docs/sources/installation/configuration.md Executable file → Normal file
View File

@ -32,7 +32,7 @@ If you installed Grafana using the `deb` or `rpm` packages, then your configurat
`sample.ini` is in the same directory as `defaults.ini` and contains all the settings commented out. Copy `sample.ini` and name it `custom.ini`. `sample.ini` is in the same directory as `defaults.ini` and contains all the settings commented out. Copy `sample.ini` and name it `custom.ini`.
**macOS** **macOS**
By default, the configuration file is located at `/usr/local/etc/grafana/grafana.ini`. By default, the configuration file is located at `/usr/local/etc/grafana/grafana.ini`. To configure Grafana, add a configuration file named `custom.ini` to the `conf` folder to override any of the settings defined in `conf/defaults.ini`.
## Comments in .ini Files ## Comments in .ini Files

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

@ -1,5 +1,5 @@
+++ +++
title = "Installing on macOS" title = "Install on macOS"
description = "Installing Grafana on macOS" description = "Installing Grafana on macOS"
keywords = ["grafana", "configuration", "documentation", "mac", "homebrew", "osx"] keywords = ["grafana", "configuration", "documentation", "mac", "homebrew", "osx"]
type = "docs" type = "docs"
@ -8,74 +8,43 @@ parent = "installation"
weight = 500 weight = 500
+++ +++
# Install on macOS
# Installing on macOS This page provides instructions to help you install Grafana on macOS.
This page provides instructions to help you install Grafana on macOS. You can either install using homebrew or a binary tar file. **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
## Install using homebrew Before you begin, you must have [Homebrew](http://brew.sh/) installed.
Installation can be done using [homebrew](http://brew.sh/) 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.
Install latest stable: ```bash
brew update
brew install grafana
```
```bash ## 2. Start Grafana
brew update
brew install grafana
```
To start grafana look at the command printed after the homebrew install completes. Start Grafana using Homebrew services:
To upgrade use the reinstall command
```bash
brew update
brew reinstall grafana
```
-------------
You can also install the latest unstable grafana from git:
```bash
brew install --HEAD grafana/grafana/grafana
```
To upgrade grafana if you've installed from HEAD:
```bash
brew reinstall --HEAD grafana/grafana/grafana
```
### Start Grafana
To start Grafana using homebrew services first make sure homebrew/services is installed.
```bash
brew tap homebrew/services
```
Then start Grafana using:
```bash ```bash
brew services start grafana brew services start grafana
``` ```
Default login and password `admin`/ `admin` ## Upgrade with Homebrew
## Install from binary tar file To upgrade Grafana, use the reinstall command:
Download [the latest `.tar.gz` file](https://grafana.com/get) and ```bash
extract it. This will extract into a folder named after the version you brew update
downloaded. This folder contains all files required to run Grafana. There are brew reinstall grafana
no init scripts or install scripts in this package. ```
To configure Grafana add a configuration file named `custom.ini` to the
`conf` folder and override any of the settings defined in
`conf/defaults.ini`.
### Start Grafana
Start Grafana by executing `./bin/grafana-server`. The `grafana-server` binary needs the working directory to be the root install directory (where the binary and the `public` folder is located).