Telegraf on Windows (Step By Step)

There are a bunch of different ways to install Telegraf on your Window PC. This tutorial will cover the most basic way of going about it via the Windows user interface.

This is a Windows specific tutorial.

This is a step-by-step tutorial. For more advanced users see the below links:


  • InfluxDB

1. Download Telegraf

Click the button:


And then copy Telegraf's URL in the area labeled "Windows Binaries (64-bit)":


Paste it into your browser's omnibar and press enter:


The Telegraf ZIP file will then download to your computer:


2. Create the Telegraf folder

Open Windows Explorer, click on This PC, double click the C:\drive:


And then drill down to C:\Program Files\:


Then create a new folder called "telegraf":


3. Open & extract the ZIP file

Now navigate to your Downloads folder to locate the Telegraf ZIP file:


Then click on the Telegraf ZIP file to open your PC's native archive application. In my case I'm using WinRAR:


Now right-clickon the Telegraf folder in your archive application, and click "Extract to Specified Folder". This verbiage may differ depending on what archive application you're using, but the gist will be very similar.


In the File Explorer tree that appears, drill down to and click on  C:\Program Files\, then click the telegraf folder we created earlier:


And then click OK.

4. Start Notepad with administrative rights

Click inside the Cortana search bar and type Notepad:


Then right-clickon Notepad in the search results and click Run As Administrator:


5. Open the Telegraf config file with Notepad

From Notepad, click File -> Open:


Then navigate to C:\Program Files\telegraf:


Change the file type to All Files:


And double click telegraf.conf:


6. Adjust telegraf.conf to connect to your Influx server

Within telegraf.conf, scroll down to where it says OUTPUTS:


Where is says:

# urls = [""]

Remove the pound symbol (#) and enter the IP address of the computer that hosts InfluxDB. If in case Telegraf is loaded on the SAME computer as InfluxDB, you can use either urls = [""] or urls = ["http://localhost:8086"].

You can change the name of the database here: (default "telegraf" is fine though)


And if your InfluxDB data source requires authentication, be sure to put the username & password here:


Now go to File -> Save and close Notepad.

7. Start Telegraf

Return to Windows Explorer and double click Telegraf, and you should see a window like this:


At this point, assuming the telegraf.conf file was configured properly and Telegraf has network access to the computer running InfluxDB, Telegraf should begin reporting metrics to Influx.

You can now enter Grafana, select either the Default or Influx data source and begin building Grafana panels with these metrics. In case there's an error, Telegraf will likely output a verbose error message within the Telegraf command window that can be research in order to isolate problems.



Back to top