{"id":49436,"date":"2025-05-22T07:22:47","date_gmt":"2025-05-22T07:22:47","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49436"},"modified":"2025-05-22T07:22:47","modified_gmt":"2025-05-22T07:22:47","slug":"guide-to-add-and-use-a-windows-node-in-rundeck-installed-on-a-linux-server","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/guide-to-add-and-use-a-windows-node-in-rundeck-installed-on-a-linux-server\/","title":{"rendered":"Guide to add and use a Windows node in Rundeck installed on a Linux server"},"content":{"rendered":"\n

Here\u2019s a step-by-step guide<\/strong> to add and use a Windows node<\/strong> in Rundeck installed on a Linux server<\/strong>, using WinRM<\/strong> (Windows Remote Management), which is the most common way to connect from Linux to Windows.<\/p>\n\n\n\n

\n\n\n\n

\ud83e\udde9 Prerequisites<\/h2>\n\n\n\n
Requirement<\/th>Notes<\/th><\/tr><\/thead>
\u2705 Windows machine<\/td>Windows 10\/11 or Server with WinRM enabled<\/td><\/tr>
\u2705 Rundeck installed on Linux<\/td>Any recent version of Rundeck (Community is fine)<\/td><\/tr>
\u2705 Network reachability<\/td>Linux (Rundeck) must reach the Windows node on port 5985 (HTTP)<\/strong> or 5986 (HTTPS)<\/strong><\/td><\/tr>
\u2705 PowerShell enabled on Windows<\/td>For remote execution<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

\ud83d\udd27 Step 1: Enable WinRM on Windows Node<\/h2>\n\n\n\n

Open PowerShell as Administrator<\/strong> on the Windows machine and run:<\/p>\n\n\n

winrm quickconfig\n<\/code><\/span><\/pre>\n\n\n
If prompted, choose y<\/code> to make the changes.<\/p>\n\n\n\n
Optional (Allow unencrypted + Basic Auth):<\/h3>\n\n\n
winrm set winrm\/config\/service '@{AllowUnencrypted=\"true\"}'<\/span>\nwinrm set winrm\/config\/service\/auth '@{Basic=\"true\"}'<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
\n
\u26a0\ufe0f This is for testing. For production, use HTTPS with a certificate<\/strong>.<\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
\ud83d\udda5 Step 2: Create Windows Node Entry in Rundeck<\/h2>\n\n\n\n
Go to:
Rundeck \u2192 Project Settings \u2192 Edit Nodes \u2192 Add a Node (Manually)<\/strong><\/p>\n\n\n\n
Or edit your resources.yaml<\/code>\/resources.xml<\/code> (depending on project config).<\/p>\n\n\n\n
Sample YAML Entry (resources.yaml<\/code>):<\/h3>\n\n\n
- nodename: win-node01\n  hostname<\/span>: 192.168<\/span>.1<\/span>.50<\/span>\n  osFamily<\/span>: windows\n  osName<\/span>: Windows\n  description<\/span>: Windows Node for<\/span> Deployment\n  tags<\/span>: windows\n  username<\/span>: Administrator\n  winrm-auth-type: basic\n  winrm-protocol: http\n  winrm-port: 5985<\/span>\n  winrm-ssl: false<\/span>\n  winrm-certificate-check: false<\/span>\n  winrm-password-storage-path: keys\/project\/windows-password\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
Store the password in Rundeck Key Storage:<\/h3>\n\n\n\n
Go to:
Rundeck \u2192 Key Storage \u2192 Add Key \u2192 Password \u2192 Path:<\/strong> keys\/project\/windows-password<\/code><\/p>\n\n\n\n
\n\n\n\n
\u2699\ufe0f Step 3: Configure Project for WinRM Plugin<\/h2>\n\n\n\n
Make sure WinRM is supported in your project:<\/p>\n\n\n\n
    \n
  1. Go to Project Settings \u2192 Edit Configuration<\/strong><\/li>\n\n\n\n
  2. Add or verify:<\/li>\n<\/ol>\n\n\n
    project.node.executor.default<\/span>=overthere-winrm\nproject.remote.file-copy.default<\/span>=overthere-winrm\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
    This ensures file copy and command execution use WinRM.<\/p>\n\n\n\n
    \n\n\n\n
    \ud83d\udce6 Step 4: Install WinRM Plugin (if missing)<\/h2>\n\n\n\n
    If WinRM plugin isn’t preinstalled, download it:<\/p>\n\n\n\n