2016-10-21 04:01:34 -05:00
+++
2019-10-07 06:20:30 -05:00
title = "Installing on macOS"
description = "Installing Grafana on macOS"
2016-10-21 04:01:34 -05:00
keywords = ["grafana", "configuration", "documentation", "mac", "homebrew", "osx"]
type = "docs"
[menu.docs]
parent = "installation"
weight = 4
+++
2015-04-13 01:14:13 -05:00
2019-10-07 06:20:30 -05:00
# Installing on macOS
2015-04-13 01:14:13 -05:00
2018-06-25 10:22:31 -05:00
## Install using homebrew
2016-05-10 09:02:00 -05:00
Installation can be done using [homebrew ](http://brew.sh/ )
Install latest stable:
2017-10-05 12:01:03 -05:00
```bash
2016-08-10 01:39:57 -05:00
brew update
2016-05-10 09:02:00 -05:00
brew install grafana
```
2016-08-10 01:39:57 -05:00
To start grafana look at the command printed after the homebrew install completes.
2016-05-10 09:02:00 -05:00
To upgrade use the reinstall command
2017-10-05 12:01:03 -05:00
```bash
2016-08-10 01:39:57 -05:00
brew update
brew reinstall grafana
2016-05-10 09:02:00 -05:00
```
2015-04-13 01:14:13 -05:00
2016-08-11 00:36:14 -05:00
-------------
2015-04-13 01:14:13 -05:00
2016-08-11 00:36:14 -05:00
You can also install the latest unstable grafana from git:
2017-10-05 12:01:03 -05:00
```bash
2016-08-11 00:36:14 -05:00
brew install --HEAD grafana/grafana/grafana
```
To upgrade grafana if you've installed from HEAD:
2017-10-05 12:01:03 -05:00
```bash
2016-08-11 00:36:14 -05:00
brew reinstall --HEAD grafana/grafana/grafana
```
2017-09-22 07:05:10 -05:00
### Starting Grafana
To start Grafana using homebrew services first make sure homebrew/services is installed.
2017-10-05 12:01:03 -05:00
```bash
2017-09-22 07:05:10 -05:00
brew tap homebrew/services
```
Then start Grafana using:
2017-10-05 12:01:03 -05:00
```bash
2017-09-22 07:05:10 -05:00
brew services start grafana
```
2018-07-11 10:15:23 -05:00
Default login and password `admin` / `admin`
2017-09-22 07:05:10 -05:00
### Configuration
The Configuration file should be located at `/usr/local/etc/grafana/grafana.ini` .
### Logs
The log file should be located at `/usr/local/var/log/grafana/grafana.log` .
### Plugins
If you want to manually install a plugin place it here: `/usr/local/var/lib/grafana/plugins` .
### Database
The default sqlite database is located at `/usr/local/var/lib/grafana`
2018-06-25 10:22:31 -05:00
## Installing from binary tar file
Download [the latest `.tar.gz` file ](https://grafana.com/get ) and
extract it. This will extract into a folder named after the version you
downloaded. This folder contains all files required to run Grafana. There are
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 by executing `./bin/grafana-server web` . The `grafana-server`
binary needs the working directory to be the root install directory (where the
binary and the `public` folder is located).
2018-08-14 06:21:52 -05:00
## Logging in for the first time
2019-09-23 09:07:11 -05:00
To run Grafana open your browser and go to http://localhost:3000/. 3000 is the default HTTP port that Grafana listens to if you haven't [configured a different port ](/installation/configuration/#http-port ).
Then follow the instructions [here ](/guides/getting_started/ ).
