The CLI tools (except rd-acl) use the Rundeck API to communicate to the Rundeck server.

Authentication to the server can happen in several ways:

Static configuration

The default mechanism is to use these properties stored in the framework.properties file:

  • framework.server.url The URL to connect to Rundeck
  • framework.server.username The username
  • framework.server.password The password

This requires storing the username/password in plaintext on the filesystem.

Environment Variables

These environment variable can be used to define the connection and authentication data:

  • RUNDECK_URL The URL to connect to Rundeck
  • RUNDECK_USER The username
  • RUNDECK_PASS The password

Example:

RUNDECK_URL=http://madmartigan.local:4440 RUNDECK_USER=admin RUNDECK_PASS=admin rd-jobs list -p test
{"cc_re__cc_re__cc_by_sa_3_0": ["<i class=\"glyphicon glyphicon-arrow-right\"></i></a></li>\n    </ul>\n</div>\n</div>\n</div>\n<div class='container footer'>\n\n<div class=\"row\">\n<footer class=\"copy col-sm-12 text-muted\">\n\n<span xmlns:dct=\"http://purl.org/dc/terms/\" href=\"http://purl.org/dc/dcmitype/Text\" property=\"dct:title\" rel=\"dct:type\">Rundeck Documentation</span> by <a xmlns:cc=\"http://creativecommons.org/ns#\" href=\"http://dtosolutions.com\" property=\"cc:attributionName\" rel=\"cc:attributionURL\">SimplifyOps</a> is licensed under a <a rel=\"license\" href=\"http://creativecommons.org/licenses/by-sa/3.0/\">Creative Commons Attribution-ShareAlike 3.0 Unported License</a>.\n<p>\n&copy;2014 <a href=\"http://simplifyops.com\">#SimplifyOps</a>\n</p>\n<p>\n<span class=\"generated-date\" title=\"2015-05-15T21:04:13UTC\">2015-05-15T21:04:13UTC</span>\n</p>\n</footer>\n</div>\n</div>\n<script type=\"text/javascript\">\n  \n\n   var _gaq = [['_setAccount', 'UA-529275-13'], ['_trackPageview']];\n   (function(d, t) {\n    var g = d.createElement(t),\n        s = d.getElementsByTagName(t)[0];\n    g.async = true;\n    g.src = ('https:'"]}