How to Add a windows Agent to jenkins

 Prerequisite

• Jenkins controller: Ubuntu 22 on AWS EC2

• On Controller (Ubuntu Jenkins)

  • Port 8080 open

  • Port 50000 open

• New agent: Windows Server (or Windows 10/11)--Lunch a new windows instance.

Then launch.... when instance is running ...Click connect to see how to connect ...then click Rdp ang get password to get password

Click Decrypt pasword to get password

Open RDP on your computer

Enter computer: Public Dns

Username: Administrator

Click connect and Enter the password

1. Prep the Windows machine

On the Windows box (the future agent):

1. Install Java (same major as controller, e.g. JDK 17 or 21)

   • Download a JDK (Temurin, Oracle, etc.) in the agent through the browser

   • https://download.java.net/java/GA/jdk21.0.2/f2283984656d49d69e91c558476027ac/13/GPL/openjdk-21.0.2_windows-x64_bin.zip

   • Install to something like: C:\Program Files\Java\jdk-21

2. Add Java to PATH (optional but helpful)

   • System Properties → Advanced → Environment Variables

   • Under System variables, edit Path → add:
     C:\Program Files\Java\jdk-21\bin

3. Create a Jenkins work directory

• For example: C:\jenkins

• Make sure the user that will run the agent (e.g. jenkins or your login) has full rights.

• 
  
  
  

4. Network

• Windows server must be able to reach the Jenkins URL over HTTP/HTTPS

• If using inbound TCP agent port (default 50000), make sure it’s open on security group if needed

2. Create the Windows node in Jenkins

On the Jenkins controller UI:

1. Go to Manage Jenkins → Nodes (or “Manage Nodes and Clouds”).

2. Click New Node.

3. Name it e.g. windows-agent-1.

4. Choose Permanent Agent → OK.

Fill in:

• # of executors: 1 (or more if the box is strong)

• Remote root directory: C:\jenkins

• Labels: e.g. windows maven (you’ll use these in jobs)

• Usage: “Use this node as much as possible”

Launch method (very important)

Set Launch method to:

Launch agent by connecting it to the controller

This means the Windows machine will run java -jar agent.jar and connect in.

Click Save.

You’ll now see the node page with instructions like “Launch agent”, “jnlp” etc.

Save 

Then from the Agent browser browse to the Jenkins

Copy the 2 commands and run from the Agent commandline

if you face issues or errors; check if port is open and all firewall

Run on Jenkins Terminal

sudo ufw allow 8080/tcp

Your Agent is now connected