Overview

Drone Runner is the Docker executor for Drone CI pipelines. DockerCP deploys the official runner image, mounts the host Docker socket required to create pipeline containers, exposes the runner dashboard port, and stores the RPC connection settings with the service. The runner must use the same RPC secret as its Drone server.

Docker image drone/drone-runner-docker:1
Default port 3000
Deployment type docker image
Recommended resources 2 CPU · 2 GB

How deployment works in DockerCP

This template gives DockerCP the deployment metadata needed to create a service, prepare runtime variables, map persistent storage, expose the internal port, and connect a public domain with SSL when required.

  1. Create or select a project where the service belongs
  2. Review the Docker image, tag, default port, environment variables, and volume mappings
  3. Deploy the service and check logs until the application is healthy
  4. Attach a domain or subdomain when the application must be available publicly
  5. Enable HTTPS and verify the final browser response

Configuration

Environment variables

Variable Default / guidance
DRONE_RPC_PROTO https
DRONE_RPC_HOST drone.example.com
DRONE_RPC_SECRET change_me
DRONE_RUNNER_CAPACITY 2
DRONE_RUNNER_NAME dockercp-runner

Persistent volumes

No persistent volume is required by the default template profile

Commands

DockerCP handles deployment from the panel, but understanding the equivalent Docker commands helps users debug services with more confidence. 

docker pull drone/drone-runner-docker:1
docker ps --filter "name=drone-runner"

docker logs --tail=100 drone-runner

DNS and SSL checklist

Step Expected result
Add A or CNAME record The domain points to the DockerCP server or configured target
Attach domain to service The service is reachable through the selected hostname
Enable HTTPS The certificate becomes active and redirect to HTTPS can be enabled

Screenshots

Panel previews for the Drone Runner template: how deployment, the running service, and its key details look inside DockerCP.

Drone Runner deployment form inside the DockerCP panel
Automation workflows running on the deployed service
Public webhook URL routed through the DockerCP proxy

Troubleshoot

  • Confirm the Docker image and tag exist
  • Confirm the selected internal port matches the application port
  • Confirm required variables such as database URL, app URL, and credentials are set
  • Check service logs after the first deployment
  • Verify DNS before requesting or renewing SSL certificates