User Tools

Site Tools


Rundeck add remote node

This example has a rundeck running in a docker container with a volume path set to /home/rundeck/server/data

Add private key

Must be in rsa format which begins like


You likely have openssh format


so this needs to be converted to rsa with

ssh-keygen -p -m PEM -f .ssh/id_rsa

Once its converted add it to Rundeck Cog wheel in upper right corner > Key Storage > Add or Upload Key

Use it in project

If you already added a project select it, go to Project settings > Edit Configuration > Default node executor, select SSH then in SSH Key Storage Path browse to the added key above. Set SSH Authentication to “privateKey”.

In “Default File Copier” tab select “SCP” with same settings as above.

When adding the new project the steps are the same.

Add a remote node

Go to Project settings > Edit Configuration > Edit nodes. Go to “Sources” and “Add a new node source” then choose “File” and set the “Format” to resourceyml and “File Path” to the name of the yaml file e.g. /home/rundeck/server/data/nodes.yml. Also tick the “Generate” and “Writeable” option.

Now go to “Edit” tab and click “Modify” and paste the configuration for the node, example:

  nodename: node1
  description: ''
  username: username
  osFamily: Linux

Test execution

Select “Commands” from the sidebar, in the dropdown click “Show all nodes” and select the node you added. Now run some simple command like ls to see if it works.

Use in job

When defining a job, in “Nodes” tab select “Dispatch to Nodes” and select your node(s) in “Node Filter”.

Tested on

  • Rundeck 4.3.0 (docker container)
  • Docker version 20.10.17, build 100c701
  • Debian 11

See also


wiki/rundeck_add_remote_node.txt · Last modified: 2022/06/23 11:01 by antisa

Except where otherwise noted, content on this wiki is licensed under the following license: CC0 1.0 Universal
CC0 1.0 Universal Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki