Skip to main content

Upgrading to Rundeck 3.2

Upgrading to Rundeck 3.2


See other Upgradingopen in new window Documents if you are upgrading from 3.0 or earlier.

Upgrading from Rundeck 3.0 Using Debian/RPM packaging

The value of framework.projects.dir in the default install of Rundeck 3.2 in the config file has changed to:


Rundeck 3.0.x has this :


If before the upgrade the /var/rundeck/projects is NOT empty, 3.2 will start properly, but if /var/rundeck/projects is empty, it will be deleted and 3.2 won't start until you modify the proper line in to be /var/lib/rundeck/projects.

An error with this message may occur in the Rundeck console at startup:

... nested exception is java.lang.IllegalArgumentException: project base directory could not be created. /var/rundeck/projects



Webhooks were feature flagged in 3.1.x and disabled by default. Your instance may not have used Webhooks prior to the 3.2 release. If you did not use Webhooks prior to version 3.2 you can skip this issue.

Advanced Run Job (Enterprise)

The conditionopen in new window type matches has been renamed to equals. Webhooks using Advanced Run Job with matches conditions will need to be updated to work properly. These configurations can be updated by:

  • Loading the webhook in the UI, selecting equals on the appropriate conditions, and then saving


  • Updating the webhooks configuration through the APIopen in new window