We need you!


The IzPack documentation needs work, and you are invited to edit it!

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


The following nested elements can be used in the <file> tag:


Limit the installation of this file to conditions depending on the target OS, see


OS Restrictions.


Operating System

  An os element in an file element indicates that this file applies to the operating system that is identified by the family attributeThis tag can also be specified in order to pass additional data related to a file tag for customizing.




Identifies an operating system to which this laf applies.

This can have a value of mac, windows or unix. Linux is considered as unix.



key to identify the data


value which can be used by a custom action

;<additionaldata> is an element which may provide additional information as key-value pairs to certain custom actions. The particular key-value pairs you might use depend on the particular custom action.

 Currently, there are two built-in custom actions consuming such data, ChmodCompilerListener and ChmodInstallerListener, where relevant keys are

  • permission.dir,
  • permission.file

with integer values interpreted as permissions like in the Unix chmod:

If value begins with "0" -> octal number,

otherwise is is a decimal number representing some permission.

These permissions are applied to the appropriate files either during the compilation of the package or while installing them later, depending on whether the consumer implements a CompilerListener or InstallerListener.