How to Install Jenkins Agent on Windows

This tutorial will teach how to install Jenkins Agent on Windows. However, before proceeding with this tutorial, we must ensure that we have Java JDK installed on the Windows machine.

It is recommended to ensure that the JDK version running on the controller is similar to that installed on the Windows machine.

Configuring Jenkins Agent

Navigate to the Jenkins controller Dashboard and select the “Build Executor Status” from the left-hand pane to set up a new Jenkins Agent.

In the available nodes page, select the “New Node” option. This will allow you to create and configure a new Jenkins Agent.

Select “New Node” on the top right to create a new Jenkins Agent. First, give the node a name. For simplicity, we will use the IP address of the target agent as the Node Name.

Next, choose the Node type as permanent Agent and click create.

In the next Window, provide all the details for your Agent, including the remote directory you wish to use as the Jenkins workspace.

Ensure to select the launch method as “Launch agent by connecting it to the controller” and select the “Use WebSocket” method.

Once completed, Click save to configure the Jenkins agent.

Head to the “Build Executor Status page” to view the available controllers. You should see the windows agent listed in the options.

Click on the Agent to view the available options. This should give you the command you need to execute to connect the Windows agent to the controller.

Copy and paste the commands into the Windows agent’s command line. This should download the agent.jar file and connect the Agent to the controller.

For example:

curl -sO http://localhost:9001/jnlpJars/agent.jar

Connecting the Agent:

java -jar agent.jar -jnlpUrl http://localhost:9001/manage/computer/windows/jenkins-agent.jnlp -secret
1f97f602e489a231bd1d5c7369bb59fc9969e2d414a890001ef5a68144c8c7dd -workDir "C:\Jenkins"

You should see the output logs as shown:

You can head back to the Jenkins controller dashboard to check on the status of the agent.


This post covered the fundamentals of connecting a Windows Jenkins agent to a controller using websocket.

About the author

John Otieno

My name is John and am a fellow geek like you. I am passionate about all things computers from Hardware, Operating systems to Programming. My dream is to share my knowledge with the world and help out fellow geeks. Follow my content by subscribing to LinuxHint mailing list