You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Docs: Edited Windows install instructions (grafana#20780)
* Edited Windows install instructions
Moved one section from Windows install guide to developer-guide.md. Edited some content in windows.md and will add questions.
* Updated per comments
* Fixed broken links in basic_concepts.md
* Revert "Fixed broken links in basic_concepts.md"
This reverts commit e524ea9.
* Update windows.md
Copy file name to clipboardexpand all lines: contribute/developer-guide.md
+4
Original file line number
Diff line number
Diff line change
@@ -72,6 +72,10 @@ Log in using the default credentials:
72
72
73
73
When you log in for the first time, Grafana asks you to change your password.
74
74
75
+
#### Building on Windows
76
+
77
+
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).
78
+
75
79
## Test Grafana
76
80
77
81
The test suite consists of three types of tests: _Frontend tests_, _backend tests_, and _end-to-end tests_.
Latest stable package for Windows | [x64](https://grafana.com/grafana/download?platform=windows)
13
+
[Download the latest stable package for Windows.](https://grafana.com/grafana/download?platform=windows)
14
+
15
+
You can either download the Windows installer package or a standalone Windows binary file.
16
16
17
17
Read [Upgrading Grafana]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing
18
18
installation.
19
19
20
-
## Configure
21
-
22
-
**Important:** After you've downloaded the zip file and before extracting it, make sure to open properties for that file (right-click Properties) and check the `unblock` checkbox and `Ok`.
23
-
24
-
The zip file contains a folder with the current Grafana version. Extract
25
-
this folder to anywhere you want Grafana to run from. Go into the
26
-
`conf` directory and copy `sample.ini` to `custom.ini`. You should edit
27
-
`custom.ini`, never `defaults.ini`.
28
-
29
-
The default Grafana port is `3000`, this port requires extra permissions
30
-
on Windows. Edit `custom.ini` and uncomment the `http_port`
31
-
configuration option (`;` is the comment character in ini files) and change it to something like `8080` or similar.
32
-
That port should not require extra Windows privileges.
20
+
## Install with Windows installer
33
21
34
-
Default login and password `admin`/ `admin`
22
+
Download the .msi installation file and run it, then follow the instructions in [Getting Started](/guides/getting_started/) to log in. The Grafana service starts automatically.
35
23
24
+
## Install standalone Windows binary
36
25
37
-
Start Grafana by executing `grafana-server.exe`, located in the `bin` directory, preferably from the
38
-
command line. If you want to run Grafana as Windows service, download
39
-
[NSSM](https://nssm.cc/). It is very easy to add Grafana as a Windows
40
-
service using that tool.
26
+
1. Download the zip file. The zip file contains a folder with the current Grafana version (or the one that you chose).
41
27
42
-
Read more about the [configuration options]({{< relref "configuration.md" >}}).
28
+
**Important:** After you've downloaded the zip file and before extracting it, make sure to open the properties for that file (right-click **Properties**) and select the `unblock` check box and then click `Ok`.
43
29
44
-
## Logging in for the first time
30
+
1. Extract this folder to anywhere you want Grafana to run from.
45
31
46
-
To run Grafana open your browser and go to the port you configured above, e.g. http://localhost:8080/.
47
-
Then follow the instructions [here]({{< relref "../guides/getting_started/" >}}).
32
+
1. Start Grafana by executing `grafana-server.exe`, located in the `bin` directory, preferably from the command line. If you want to run Grafana as a Windows service, then download
33
+
[NSSM](https://nssm.cc/). It is very easy to add Grafana as a Windows service using that tool.
48
34
49
-
## Building on Windows
35
+
To run Grafana open your browser and go to the Grafana port (http://localhost:3000/ is default) and then follow the instructions in [Getting Started](/guides/getting_started/).
50
36
51
-
The Grafana backend includes Sqlite3 which requires GCC to compile. So
52
-
in order to compile Grafana on Windows you need to install GCC. We
> **Note:** The default Grafana port is `3000`. This port might require extra permissions on Windows. If it does not appear in the default port, you can try changing to a different port.
38
+
> 1. Go into the `conf` directory and copy `sample.ini` to `custom.ini`. **Note:** You should edit `custom.ini`, never `defaults.ini`.
39
+
> 1. Edit `custom.ini` and uncomment the `http_port` configuration option (`;` is the comment character in ini files) and change it to something like `8080` or similar. That port should not require extra Windows privileges.
40
+
> Read more about the [configuration options]({{< relref "configuration.md" >}}).
0 commit comments