Files
Christopher Moyer a568d421f8 Docs: Setup refactor (#49739)
* builds out refactored setup topics

* Automatically fix some relrefs with mv-manager

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Use refs for tutorials content which is outside of this repository

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Manually fix complicated relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* consolidates team sync and db encryption topics

* Fix relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* updates setup index file

* Convert TOML to YAML

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Add current alias for new alerting content

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Add current aliases to new setup-grafana and configure-security pages

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* Update docs/sources/setup-grafana/configure-grafana/_index.md

Co-authored-by: Torkel Ödegaard <torkel@grafana.com>

* moves saml docs, updates order in TOC

* Manually fix relrefs

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* added usage insights topics, adjusted weights

* corrected relrefs

* Fix relrefs broken in rebase

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Torkel Ödegaard <torkel@grafana.com>
2022-06-02 11:57:22 -05:00

2.9 KiB

aliases description title weight
/docs/grafana/latest/installation/mac/
/docs/grafana/latest/setup-grafana/installation/mac/
Installing Grafana on macOS Install on macOS 600

Install on macOS

This page explains how to install Grafana and get the service running on your 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. Before you perform an upgrade, read [Upgrading Grafana]({{< relref "../upgrade-grafana/" >}}) for tips and guidance on updating an existing installation.

Install with Homebrew

Use Homebrew to install the most recent released version of Grafana using Homebrew package.

  1. On the Homebrew homepage, search for Grafana. The last stable and released version is listed.

  2. Open a terminal and enter:

    brew update
    brew install grafana
    

    The brew page downloads and untars the files into:

    • /usr/local/Cellar/grafana/[version] (Homebrew v2)
    • /opt/homebrew/Cellar/grafana/[version] (Homebrew v3)
  3. Start Grafana using the command:

    brew services start grafana
    

Install standalone macOS binaries

To install a nightly build, or to install the latest version of Grafana without Homebrew, go to the Grafana download page.

  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.

  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. Open a terminal and download the binary using the cURL command. The following example shows Grafana 7.1.5 version:

    curl -O https://dl.grafana.com/oss/release/grafana-7.1.5.darwin-amd64.tar.gz
    
  5. Untar the gz file and copy the files to the location of your preference.

  6. To start Grafana service, go to the directory and run the command:

    ./bin/grafana-server web
    

Next steps

Refer to the [Getting Started]({{< relref "../../getting-started/build-first-dashboard/" >}}) guide for information about logging in, setting up data sources, and so on. Also, refer to the [Configuration]({{< relref "../configure-grafana/" >}}) page for details on options for customizing your environment, logging, database, and so on.

Upgrade

Using Homebrew

To upgrade Grafana, use the reinstall command:

brew update
brew reinstall grafana