Need help with docker-agent?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

148 Stars 156 Forks MIT License 302 Commits 12 Opened issues


Base Docker image for Jenkins Agents

Services available


Need anything else?

Contributors list

Jenkins Agent Docker image

Join the chat at GitHub stars Docker Pulls GitHub release

This is a base image for Docker, which includes JDK and the Jenkins agent executable (agent.jar). This executable is an instance of the Jenkins Remoting library. JDK version depends on the image and the platform, see the Configurations section below.

:exclamation: Warning! This image used to be published as jenkinsci/slave and jenkins/slave. These images are now deprecated, use jenkins/agent.


See GitHub releases for versions

and above. There is no changelog for previous versions, see the commit history.

Jenkins remoting changelogs are available here.


This image is used as the basis for the Docker Inbound Agent image. In that image, the container is launched externally and attaches to Jenkins.

This image may instead be used to launch an agent using the Launch method of Launch agent via execution of command on the master. For example on Linux you can try

docker run -i --rm --name agent --init jenkins/agent java -jar /usr/share/jenkins/agent.jar

after setting Remote root directory to


or if using Windows Containers

docker run -i --rm --name agent --init jenkins/agent:jdk8-windowsservercore-1809 java -jar C:/ProgramData/Jenkins/agent.jar

after setting Remote root directory to


Agent Work Directories

Starting from Remoting 3.8 there is a support of Work directories, which provides logging by default and change the JAR Caching behavior.

Call example for Linux:

docker run -i --rm --name agent1 --init -v agent1-workdir:/home/jenkins/agent jenkins/agent java -jar /usr/share/jenkins/agent.jar -workDir /home/jenkins/agent

Call example for Windows Containers:

docker run -i --rm --name agent1 --init -v agent1-workdir:C:/Users/jenkins/Work jenkins/agent java -jar C:/ProgramData/Jenkins/agent.jar -workDir C:/Users/jenkins/Work


The image has several supported configurations, which can be accessed via the following tags:

  • latest
    : Latest version with the newest remoting (based on
  • latest-stretch
    : Latest version with the newest remoting (based on
  • latest-jdk11
    : Latest version with the newest remoting and Java 11 (based on
  • alpine
    : Small image based on Alpine Linux (based on
  • jdk8-windowsservercore-1809
    : Latest version with the newest remoting (based on
  • jdk11-windowsservercore-1809
    : Latest version with the newest remoting and Java 11 (based on
  • jdk8-nanoserver-1809
    : Latest version with the newest remoting with Windows Nano Server
  • jdk11-nanoserver-1809
    : Latest version with the newest remoting with Windows Nano Server and Java 11

There are also versioned tags in DockerHub, and they are recommended for production use. See the full list here

Java 11 Support

Java 11 support is available for Debian-based images and Windows images. Alpine image for Java 11 will not be provided, see JENKINS-54487. There is a probability that images for Java 11 will be changed to AdoptOpenJDK base images in the future.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.