Version 1.0.0
Language EN

Linux amd64

This article explains how to install the docker runner. The docker runner is packaged and distributed as a Docker image on Docker Hub.

Step 1 - Download

Install Docker and pull the public image:

$ docker pull drone/agent:1

Step 2 - Configure

The docker runner is configured using environment variables. This article references the below configuration options. See Reference 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 - Install

The below command creates the a container and start the docker runner. Remember to replace the environment variables below with your Drone server details.

$ docker run -d \
  -e DRONE_RPC_PROTO=https \
  -e \
  -e DRONE_RPC_SECRET=super-duper-secret \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart always \
  --name runner \

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.