* organizes releases into their own pages; moves upgrade guide to the root * adds and removes aliases * Update docs/sources/upgrade-guide/upgrade-v8.0/index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/upgrade-guide/upgrade-v8.0/index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/upgrade-guide/upgrade-v8.0/index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/upgrade-guide/upgrade-v9.3/index.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/shared/upgrade/upgrade-common-tasks.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/shared/upgrade/upgrade-common-tasks.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * Update docs/sources/shared/upgrade/upgrade-common-tasks.md Co-authored-by: Jack Baldry <jack.baldry@grafana.com> * corrects relrefs --------- Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
2.8 KiB
aliases | description | title | weight | |
---|---|---|---|---|
|
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-guide/" >}}) 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.
-
On the Homebrew homepage, search for Grafana. The last stable and released version is listed.
-
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)
-
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.
-
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.
-
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.
-
Click Mac.
-
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
-
Untar the gz file and copy the files to the location of your preference.
-
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