NiFi System Properties
Also available as:

Custom Properties

To configure custom properties for use with NiFi's Expression Language:

  • Create the custom property. Ensure that:

    • Each custom property contains a distinct property value, so that it is not overridden by existing environment properties, system properties, or FlowFile attributes.

    • Each node in a clustered environment is configured with the same custom properties.

  • Update with the location of the custom property file(s):



This is a comma-separated list of file location paths for one or more custom property files.

  • Restart your NiFi instance(s) for the updates to be picked up.

Custom properties can also be configured in the NiFi UI.

Take care when configuring the properties above that are marked with an asterisk (*). To make the upgrade process easier, it is advisable to change the default configurations to locations outside the main root installation directory. In this way, these items can remain in their configured location through an upgrade, and NiFi can find all the repositories and configuration files and pick up where it left off as soon as the old version is stopped and the new version is started. Furthermore, the administrator may reuse this file and any other configuration files without having to re-configure them each time an upgrade takes place. As previously noted, it is important to check for any changes in the file of the new version when upgrading and make sure they are reflected in the file you use.