Version 1.0.0
Language EN


This article explains how to install the exec runner on Windows. The exec runner is packaged in binary format and distributed as a Github release.

Step 1 - Download

Download and unpack the binary.

curl -L${VERSION}/drone_runner_exec_windows_amd64.tar.gz | tar zx
sudo install -t /usr/local/bin drone-runner-exec

Step 2 - Configure

The exec runner is configured using an environment variable file. The environment file should be stored at the following path:


This file should use the syntax <variable>=value which sets the variable to the given value and # for comments. Please note this is not a bash file. Bash syntax and Bash expressions are not supported.


This article references the below configuration options. See Configuration for a complete list of configuration options.

provides the hostname (and optional port) of your Drone server. The runner connects to the server at the host address to receive pipelines for execution.
provides the protocol used to connect to your Drone server. The value must be either http or https.
provides the shared secret used to authenticate with your Drone server. This must match the secret defined in your Drone server configuration.

Step 3 - Configure Logging

The exec runner writes logs to a file on the host machine. The log file location must be configured before you start the service.


The log file directory must be created before you start the service:

mkdir C:\Drone
mkdir C:\Drone\drone-runner-exec

Step 4 - Install

Install and start the service.

drone-runner-exec service create
drone-runner-exec server start

Step 5 - Verify

Inspect the logs and verify the runner successfully established a connection with the Drone server.

$ cat C:\Drone\drone-runner-exec\log.txt

INFO[0000] starting the server
INFO[0000] successfully pinged the remote server

Getting Help

Mailing List
Search for information in the mailing list archives, or post a question.
Chat Support
Real-time chat support from maintainers and community members.