Version 1.0.0
Language EN

Linux arm

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.

DRONE_RPC_HOST
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.
DRONE_RPC_PROTO
provides the protocol used to connect to your Drone server. The value must be either http or https.
DRONE_RPC_SECRET
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 DRONE_RPC_HOST=drone.company.com \
  -e DRONE_RPC_SECRET=super-duper-secret \
  -e DRONE_RUNNER_CAPACITY=2 \
  -e DRONE_RUNNER_NAME=${HOSTNAME} \
  -p 3000:3000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --restart always \
  --name runner \
  drone/agent:1

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.