2016-10-21 11:01:34 +02:00
+++
title = "Installing on Windows"
description = "Installing Grafana on Windows"
keywords = ["grafana", "configuration", "documentation", "windows"]
type = "docs"
[menu.docs]
parent = "installation"
weight = 3
+++
2015-04-13 08:14:13 +02:00
2016-10-21 11:01:34 +02:00
# Installing on Windows
2015-04-21 13:30:15 +02:00
Description | Download
------------ | -------------
2018-05-07 14:57:18 +02:00
Latest stable package for Windows | [grafana-5.1.1.windows-x64.zip ](https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana-5.1.1.windows-x64.zip )
2018-04-26 18:56:44 +02:00
<!--
2018-04-20 13:23:45 +02:00
Latest beta package for Windows | [grafana.5.1.0-beta1.windows-x64.zip ](https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana-5.0.0-beta5.windows-x64.zip )
2018-04-26 18:56:44 +02:00
-->
2015-04-21 13:30:15 +02:00
2017-04-28 10:58:26 +02:00
Read [Upgrading Grafana ]({{< relref "installation/upgrading.md" >}} ) for tips and guidance on updating an existing
installation.
2015-04-21 13:30:15 +02:00
## Configure
2015-05-10 16:52:40 -04: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 13:30:15 +02:00
2015-05-10 16:52:40 -04:00
The default Grafana port is `3000` , this port requires extra permissions
on windows. Edit `custom.ini` and uncomment the `http_port`
2017-09-12 11:07:20 +02:00
configuration option (`;` is the comment character in ini files) and change it to something like `8080` or similar.
2015-05-10 16:52:40 -04:00
That port should not require extra Windows privileges.
2018-02-27 13:26:53 +01:00
Start Grafana by executing `grafana-server.exe` , located in the `bin` directory, preferably from the
2015-05-10 16:52:40 -04:00
command line. If you want to run Grafana as windows service, download
2018-02-27 13:26:53 +01:00
[NSSM ](https://nssm.cc/ ). It is very easy to add Grafana as a Windows
2015-05-10 16:52:40 -04:00
service using that tool.
2015-04-21 13:30:15 +02:00
2016-10-21 11:01:34 +02:00
Read more about the [configuration options ]({{< relref "configuration.md" >}} ).
2015-04-13 08:14:13 +02:00
2015-04-19 09:44:14 +02:00
## Building on Windows
2015-04-13 08:14:13 +02:00
2015-05-10 16:52:40 -04: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 ).