2015-04-13 01:14:13 -05:00
|
|
|
---
|
|
|
|
|
page_title: Installing on Windows
|
|
|
|
|
page_description: Grafana Installation guide for Windows
|
|
|
|
|
page_keywords: grafana, installation, windows guide
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Installing on Windows
|
|
|
|
|
|
2015-04-21 06:30:15 -05:00
|
|
|
## Download
|
|
|
|
|
|
|
|
|
|
Description | Download
|
|
|
|
|
------------ | -------------
|
2016-05-23 04:49:07 -05:00
|
|
|
Stable Zip package for Windows | [grafana.3.0.3.windows-x64.zip](https://grafanarel.s3.amazonaws.com/winbuilds/dist/grafana-3.0.3.windows-x64.zip)
|
2015-04-21 06:30:15 -05:00
|
|
|
|
|
|
|
|
## Configure
|
|
|
|
|
|
2015-05-10 15:52:40 -05:00
|
|
|
The zip file contains a folder with the current Grafana version. Extract
|
|
|
|
|
this folder to anywhere you want Grafana to run from. Go into the
|
|
|
|
|
`conf` directory and copy `sample.ini` to `custom.ini`. You should edit
|
|
|
|
|
`custom.ini`, never `defaults.ini`.
|
2015-04-21 06:30:15 -05:00
|
|
|
|
2015-05-10 15:52:40 -05:00
|
|
|
The default Grafana port is `3000`, this port requires extra permissions
|
|
|
|
|
on windows. Edit `custom.ini` and uncomment the `http_port`
|
|
|
|
|
configuration option and change it to something like `8080` or similar.
|
|
|
|
|
That port should not require extra Windows privileges.
|
|
|
|
|
|
|
|
|
|
Start Grafana by executing `grafana-server.exe`, preferably from the
|
|
|
|
|
command line. If you want to run Grafana as windows service, download
|
|
|
|
|
[NSSM](https://nssm.cc/). It is very easy add Grafana as a Windows
|
|
|
|
|
service using that tool.
|
2015-04-21 06:30:15 -05:00
|
|
|
|
2015-05-10 15:15:34 -05:00
|
|
|
Read more about the [configuration options](/installation/configuration).
|
2015-04-13 01:14:13 -05:00
|
|
|
|
2015-04-19 02:44:14 -05:00
|
|
|
## Building on Windows
|
2015-04-13 01:14:13 -05:00
|
|
|
|
2015-05-10 15:52:40 -05:00
|
|
|
The Grafana backend includes Sqlite3 which requires GCC to compile. So
|
|
|
|
|
in order to compile Grafana on Windows you need to install GCC. We
|
|
|
|
|
recommend [TDM-GCC](http://tdm-gcc.tdragon.net/download).
|
2015-04-19 02:44:14 -05:00
|
|
|
|
2015-05-10 15:52:40 -05:00
|
|
|
Copy `conf/sample.ini` to a file named `conf/custom.ini` and change the
|
|
|
|
|
web server port to something like 8080. The default Grafana port, 3000,
|
|
|
|
|
requires special privileges on Windows.
|
