Drone-runner-* Healthcheck End Point

Hi, currently I’m continuing my drone setup and using drone-runner-docker:1.6.3 on my own machine but one thing I’m missing or just oversight…

I’ve taken a look into the drone-runner-docker documentation which writes:

Use the docker logs command to view the logs and verify the runner successfully established a connection with the Drone server.

The question is: Does the drone-runner-docker (other drone-runners might be effected as well) has a health-check endpoint because unfortunately I couldn’t find anything in the docs…

It would make a lot of sense, cause I could enhance my docker-compose/stack file with a healthcheck to see if the connection to the server on the runners has been done successfully…

Hello khmarbaise,

This looks to be a valid ask, you could raise it here : Trello with the priority.


Hello khmarbaise,

You can expose port 3000 for the agent to access the following endpoint:

  • /varz returns some basic agent statistics, including currently running builds
  • /healthz returns 200 if agent is healthy
  • /version returns the version information

Please check if this helps otherwise raise it on Trello as suggested above.

Harness Support

I have tested the suggestions you have given:

[root... ~]# docker ps -a 
CONTAINER ID        IMAGE                                      COMMAND                  CREATED             STATUS                     PORTS                                           NAMES
a117aa657242        drone/drone-runner-docker:1.6.3            "/bin/drone-runner-d…"   3 days ago          Up 3 days        >3000/tcp                          drone_drone_runner_1_1
[root@titan ~]# docker exec -it a117aa657242 /bin/sh
/ # wget
Connecting to (
wget: can't connect to remote host ( Connection refused
/ # wget
wget: can't connect to remote host ( Connection refused

So I have tried to access the endpoint from inside the container which are obviously not available. Neither I have found some kind of endpoint definition within the code…(may be I oversight something) but based on my test I would say it does not exist…

So I will raise an issue on Trello…

Apart from that thanks for your answer…
Kind regards
Karl Heinz Marbaise

So I have gone to Trello but unfortunately I can’t create some kind of entry there… maybe I just miss it… Can someone give me a short hint how to create an entry there… Many thanks in advance.

Kind regards
Karl Heinz Marbaise

Hello khmarbaise,

You will need to create an account there and then you can raise it.