Version 1.0.0
Language EN

Windows 1803

The goal of this document is to give you enough technical specifics to configure and run one or many agents. The agent requests builds from the central server, allowing you to scale your CI/CD infrastructure across multiple machines, operating systems and architectures. You should install one agent per-server.

Download the Agent

The Drone agent is distributed as a lightweight Docker image. The image is self-contained and does not have any external dependencies.

docker pull drone/agent:windows-1803-amd64

Start the Agent

The agent container can be started with the below command. The container is configured through environment variables.

$ docker run \
  --volume=//./pipe/docker_engine://./pipe/docker_engine \
  --restart=always \
  --detach=true \
  --name=agent \

Configuration Reference

Configuration parameters are set using environment variables. This section defines a subset of recommended configuration parameters. For a full list, please see our configuration reference.


Required string literal value provides your drone server address. The string must be a valid url, and should omit the trailing slash.



Required string literal value provides the drone shared secret. This is used to authenticate the rpc connection to the server. The server and agent must be provided the same secret value.



Optional string literal value defines the machine name. The machine name is stored for each build, allowing you to identify the server on which a build executed. Defaults to the container HOSTNAME.


An integer defining the maximum number of pipelines the agent should execute concurrently. The default value is two pipelines.


Docker Reference


The agent requires access to your host machine Docker daemon via named pipe. This is used to launch pipelines in Docker containers on the host machine.


On This Page:

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.