Version 1.0.0
Language EN

Linux amd64

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.

Running the Agent

The Drone agent is distributed as a lightweight Docker image. The image is self-contained and does not have any external dependencies. The agent can be downloaded and started with the below command.

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

Configuration Reference

This section provides additional explanation of the configuration variables used earlier in this document. This represents a subset of configuration parameters. Please see the configuration reference for a complete list.


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 socket. 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.