How to configure Jenkins config-history Directory Change?

Article ID:203846830
1 minute readKnowledge base


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?


CloudBees Jenkins Enterprise


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.