Jenkins : Custom Tools Plugin

Plugin Information

View Custom Tools on the plugin site for more information.

A generic tool installer. You define how tools get installed, and the plugin will automatically install them when needed. 


A job will often require a tool not already installed on your Jenkins agents. In large environments, this often results in waiting on an administrator. The goal of this plugin is to let users manage their own tools, without requiring this administrator involvement. Using this plugin, you can define a script (or just a URL) for installing a tool using standard Jenkins Tool Installers. Plugins like Extra Tool Installers can be also used in this plugin. You then define which jobs require the tool, and the plugin installs them as needed before the build runs.

See the plugin documentation here.

Version History

Newer releases

See GitHub Releases

Version 0.6 (Oct 30, 2018)

  • JENKINS-54154 - Fix passing of Tool Properties for custom tools when configured via Jenkins Configuration as Code plugin (installers, etc.)

Version 0.5 (Apr 08, 2017)

  • Update the core baseline to 1.609.3 (last one with Java 6 support)
  • Update plugin to the new plugin parent POM
  • Cleanup FindBugs issues in the plugin

This is just a maintenance release, new features will be delivered later.

Version 0.4.4 (Oct 15, 2014)

  • (info) Properly escape special symbols in Additional vars coming from substituted variables (JENKINS-24113)

Version 0.4.3 (Oct 09, 2014)

  • (error) Be robust against null multi-configuration options after plugin upgrades (JENKINS-24853)
  • (error) Respect slave platform while constructing environment variables (JENKINS-14515)

Version 0.4.2 (06/29/2014)

  • (info) Support of tool version parameters in CLI build commands (JENKINS-22923)
  • (info) Reduce the size of the configuration page by adding the Advanced section (JENKINS-20909)
  • (error) Return non-null default values for CLI to workaround JENKINS-15094 in Jenkins core (JENKINS-22925)
  • (error) Throw errors if the configured tool cannot be found (JENKINS-18814)
  • (error) Properly handle missing tools in the Install wrapper to avoid NPEs (JENKINS-22075)

Version 0.4.1 (11/25/2013)

Version 0.4 (09/08/2013)

Version 0.3 (08/02/2013)

  • Change of ownership. New owner: Oleg Nenashev, Synopsys Inc.,
  • New features:
    • JENKINS-18774 - New option: Setup of label-specific environment variables (useful for LD_LIBRARY_PATH, etc.)
    • JENKINS-18707 - New option: Skip installation of tool at MatrixBuild's master job
    • JENKINS-17844 - Improvement: Environment Variables expansion in ExportedPaths and ToolHome
    • Partial replacement of the Tool Environment Plugin. Custom Tools can export HOME variables in different cases (ex, Tool_HOME and TOOL_HOME)
  • Bug fixes:
    • JENKINS-18815 - Home variables substitution doesn't work properly in case of leading variable
    • JENKINS-18481 - BuildWrapper throws NPE if user doesn't select any tool 
    • JENKINS-14515 - Malformed path variable in case of different operating systems at master and slave
    • JENKINS-13285 - customtools-plugin does not delegate the Launcher.isUnix() call in DecoratedLauncher