NAnt Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID nant Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.4.3 (archives)
Nov 01, 2012
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
Justin Holzer (id: jholzer)
Usage Installations 2014-Nov 1818
2014-Dec 1810
2015-Jan 1819
2015-Feb 1836
2015-Mar 1928
2015-Apr 1868
2015-May 1871
2015-Jun 1945
2015-Jul 1944
2015-Aug 1897
2015-Sep 1940
2015-Oct 1969

This plugin allows for the execution of a NAnt build as a build step.

This plugin provides functionality similar to the Ant features built in to Jenkins. Windows environments and non-Windows environments, running NAnt via Mono, are supported.


Using the plugin without any configuration (recommended)

If the NAnt executable is in your system's path, then you can use the default executable without any further configuration. Unless there is a need to use multiple versions of NAnt, this approach is recommended rather than configuring an installation.

  • Windows: the default executable is
  • Other OS's: the default executable is

Configuring a NAnt installation (optional)

  1. Go to the Jenkins configuration page (i.e. http(s)://<your-jenkins-url>/configure)
  2. Add a new NAnt installation in the NAnt Builder section
  3. Enter a name for the installation (i.e. nant-0.86-beta1)
  4. Enter the NAnt home directory.
    • Windows: this must be a directory where the nant executable can be found from the relative path
    • Other OS's (Mac, Linux, etc.): this must be a directory where the NAnt executable can be found from the relative path

Note: If you have a master-slave configuration where one node is running on Windows and the other running on a Unix-based platform, you can configure a NAnt installation based on the node you wish to target. Even if the plugin shows validation errors, you will still be able to save the configuration. There are future plans to clean this functionality up, but for now you will just have to ignore any validation errors.

Adding a NAnt build step

  1. Open the configuration for a new or existing Jenkins freestyle build job
  2. In the "Build" section, add a new "Top Level NAnt Target" build step
  3. Choose a NAnt installation from the dropdown
  4. Optionally enter a build file
    • The build file path, if entered, is relative to the workspace root directory
  5. Optionally enter targets (separate multiple targets by a space)
  6. Click the "Advanced" button to enter optional property definitions.
    • Property definitions are entered 1 per line, in the following format:
    • Use of build parameters is supported when setting property values


Version 1.4.3 (Nov 1, 2012)

Version 1.4.2 (Aug 5, 2011)

  • Update for Jenkins

Version 1.4.1 (Mar 4, 2010)

  • The default executable will now be chosen based on the platform of the node that NAnt is running on. Previously, the default executable was being chosen based on the platform that the master node was running on, even if a build was being done on a slave node.

Version 1.4

  • Resolved an issue regarding the configuration and execution of the NAnt plugin on non-Windows pltforms (i.e. Linux, Mac, etc.) (JENKINS-4504)

Version 1.3.1

  • Changed the supported/dependent Hudson version to 1.347

Version 1.3

  • Added the ability to set property values that will be passed to a NAnt build.
    • This is equivalent to the functionality provided by the Ant task.

Version 1.2


plugin-builder plugin-builder Delete
plugin-dotnet plugin-dotnet Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Add Comment