From 8febceb67aeb85a8285665f255973e5b343d7180 Mon Sep 17 00:00:00 2001 From: Diana Payton <52059945+oddlittlebird@users.noreply.github.com> Date: Fri, 3 Jan 2020 15:10:57 -0800 Subject: [PATCH] Docs: Update Windows.md (#21333) Updated instructions to reflect the changes to the installation page. --- docs/sources/installation/windows.md | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/docs/sources/installation/windows.md b/docs/sources/installation/windows.md index 10dfc784034..83c45c9dadb 100644 --- a/docs/sources/installation/windows.md +++ b/docs/sources/installation/windows.md @@ -1,6 +1,6 @@ +++ title = "Install on Windows" -description = "Installing Grafana on Windows" +description = "Install Grafana on Windows" keywords = ["grafana", "configuration", "documentation", "windows"] type = "docs" [menu.docs] @@ -17,22 +17,34 @@ You can either download the Windows installer package or a standalone Windows bi Read [Upgrading Grafana]({{< relref "upgrading.md" >}}) for tips and guidance on updating an existing installation. -## Install with Windows installer +1. Select a Grafana version you want to install. + * The most recent Grafana version is selected by default. + * The **Version** field displays only finished releases. If you want to install a beta version, click **Nightly Builds** and then select a version. +1. Select an **Edition**. + * **Enterprise** - Recommended download. Functionally identical to the open source version, but includes features you can unlock with a license if you so choose. + * **Open Source** - Functionally identical to the enterprise version, but you will need to download the enterprise version if you want enterprise features. +1. Click **Windows**. -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. +You can either use the Windows installer or you can install a standalone Windows binary. + +## Install with Windows installer (recommended) + +1. Click **Download the installer**. +1. Open and run the installer. + +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/). ## Install standalone Windows binary -1. Download the zip file. The zip file contains a folder with the current Grafana version (or the one that you chose). - +1. Click **Download the zip file**. **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`. -1. Extract this folder to anywhere you want Grafana to run from. +2. Extract this folder to anywhere you want Grafana to run from. -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 +3. 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 [NSSM](https://nssm.cc/). It is very easy to add Grafana as a Windows service using that tool. -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/). +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/). > **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. > 1. Go into the `conf` directory and copy `sample.ini` to `custom.ini`. **Note:** You should edit `custom.ini`, never `defaults.ini`.