How to configure Jenkins config-history Directory Change?

Issue

We are planning to move config-history directory and its contents from JENKINS_HOME to a new locaion. How do I configure the change in config-history after moving the directory and data to a different directory?

Environment

CloudBees Jenkins Enterprise

Resolution

To modify use the jenkins global configuration page JENKINS_URL/configure, Job Config History section.

Job config history global configuration lets you define path to the history directory. If this path is absolute (/some-path orX:\some-path) then the plugin do append config-history. If this path is relative it will be computed from JENKINS_HOME and also append config-history.

So as a resume you can’t prevent the plugin to use config-history as last level for history root directory, but can move it to another place. As a workaround you can just rely on symlinks.

This article is part of our Knowledge Base and is provided for guidance-based purposes only. The solutions or workarounds described here are not officially supported by CloudBees and may not be applicable in all environments. Use at your own discretion, and test changes in a safe environment before applying them to production systems.