Native Image

Creates a Native Image binary using GraalVM Native Image.

You need a local installation of GraalVM. JReleaser will not install GraalVM for you, however it can install the native-image command if needed. You may configure the JDKs Maven Plugin or the JDKs Gradle Plugin to downloads a GraalVM distribution.

Configuration

Legend:

required
optional
may use environment variable
accepts Name Templates

YAML
TOML
JSON
Maven
Gradle

# 
assemble:
  # 
  nativeImage:
    # Assemblers require a name.
    # 
    app:

      # Enables or disables the assembler.
      # Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
      # Defaults to `NEVER`.
      #  
      active: ALWAYS

      # Export the assembled artifacts as a matching named distribution.
      # Defaults to `true`.
      # 
      exported: true

      # The stereotype of this assembler.
      # Supported values are [`NONE`, `CLI`, `DESKTOP`, `WEB`, `MOBILE`].
      # Defaults to `#{project.stereotype}`.
      # 
      stereotype: CLI

      # Additional properties used when evaluating templates.
      #  
      extraProperties:
        # Key will be capitalized and prefixed with `nativeImage`, i.e, `nativeImageFoo`.
        foo: bar

      # 
      platform:
        # Key value pairs.
        # Keys match a full platform or an os.name, os.arch.
        # Same rules apply as in Platform.
        # 
        replacements:
          osx-x86_64: mac
          aarch_64: aarch64
          x86_64: amd64
          linux_musl: alpine

      # Name of the executable launcher.
      # If left undefined, will use `#{assembler.name}`.
      # 
      executable: app

      # Name of the generated image.
      # If left undefined, will use
      # `#{assembler.executable}-#{project.version}`.
      # Generated artifacts always have the platform as suffix.
      #  
      imageName: 'app-{{projectVersion}}'

      # Name transformation of the generated image.
      # Transformed artifacts always have the platform as suffix.
      #  
      imageNameTransform: 'app-{{projectEffectiveVersion}}'

      # Archive format to use.
      # Supported values are [`ZIP`, `TAR`, `TAR_BZ2`, `TAR_GZ`, `TAR_XZ`, `TBZ2`, `TGZ`, `TXZ`].
      # Defaults to `ZIP`.
      # 
      archiveFormat: TGZ

      # List of Graal JDKs.
      #  
      graalJdks:
        - path: path/to/jdk
          platform: osx-x86_64
        - path: path/to/jdk
          platform: linux-x86_64

      # A list of build arguments.
      # The `-H:Name` argument will always be replaced with the
      # value of $executable.
      # 
      args:
        - '--install-exit-handlers'

      # A list of additional GraalVM components to be installed.
      # 
      components:
        - 'espresso'

      # Compress the resulting executable with UPX.
      # 
      upx:
        # Enables or disables UPX.
        # Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
        # Defaults to `NEVER`.
        # 
        active: ALWAYS

        # Tool version.
        # 
        version: '3.96'

        # A list of arguments.
        # 
        args:
          - '-f'

      # 
      linux:
        # A list of arguments.
        # 
        args:
          - '--static'

      # 
      windows:
        # A list of arguments.
        # 
        args:
          - '--foo'

      # 
      osx:
        # A list of arguments.
        # 
        args:
          - '--bar'

      # 
      options:
        # Timestamp to use for each entry.
        # Must follow ISO-8601 +HH:MM timezone offset.
        # Example: 2023-03-08T12:56:33.024578+01:00
        # Defaults to timestamp for latest git commit or current time.
        # 
        timestamp: '2020-01-01T00:00:00.000000+00:00'

        # Set longFileMode for tar archives.
        # Possible values are [`ERROR`, `GNU`, `POSIX`, `TRUNCATE`].
        # Defaults to `ERROR`.
        # 
        longFileMode: POSIX

        # Set bigNumberMode for tar archives.
        # Possible values are [`ERROR`, `GNU`, `POSIX`].
        # Defaults to `ERROR`.
        # 
        bigNumberMode: POSIX

      # The executable JAR that contains the application.
      #  
      mainJar:
        path: path/to/app.jar

      # Defines a list of additional JARs as globs.
      # 
      jars:
          # The pattern to use.
          # May use glob or regex pattern syntax.
          #  
        - pattern: path/to/**/*.jar

      # 
      java:
        # Name of main module (if any).
        # Define only if the application is modular.
        # 
        mainModule: com.acme.demo

        # The application's entry point.
        # If left undefined, will use `#{project.java.mainClass}`.
        # 
        mainClass: com.acme.Main

        # Maven coordinates: groupId.
        # If left undefined, will use `#{project.java.groupId}`.
        # 
        groupId: com.acme

        # Maven coordinates: artifactId.
        # If left undefined, will use `#{project.java.artifactId}`.
        # 
        artifactId: app

        # The minimum Java version required by consumers to run the application.
        # If left undefined, will use `#{project.java.version}`.
        # 
        version: 8

        # Identifies the project as being member of a multi-project build.
        # If left undefined, will use `#{project.java.multiProject}`.
        # 
        multiProject: false

        # Additional properties used when evaluating templates.
        # 
        extraProperties:
          # Key will be capitalized and prefixed with `java`, i.e, `javaFoo`.
          foo: bar


      # Directory with file templates used to prepare the assembler.
      # Defaults to `src/jreleaser/assemblers/#{distribution.name}/nativeImage`.
      # If specified, path must exist.
      # 
      templateDirectory: path/to/nativeImage/templates

      # List of template files to be skipped.
      # Value may be an exact match or a regex.
      # 
      skipTemplates:
        - README.md.tpl

      # Defines a list of additional files as artifacts.
      # These files will be added to the assembled archive.
      #  
      artifacts:
        - path: path/to/file
        - path: path/to/another_file
          transform: path/inside/archive
        - path: path/to/platform/specific/file
          platform: osx-x86_64

      # Defines a list of additional files as globs.
      # These files will be added to the assembled archive.
      # 
      files:
          # The pattern to use.
          # May use glob or regex pattern syntax.
          #  
        - pattern: path/to/**/*.txt

      # Defines a list of additional files as filesets.
      # These files will be added to the assembled archive.
      # 
      fileSets:
          # The input directory to copy files from.
          #  
        - input: path/to/input/directory

          # The target path inside the archive.
          # If left undefined, defaults to the root of the archive.
          #  
          output: path/to/archive/entry

          # Fail if the given `input` does not exist.
          # Defaults to `true`.
          # 
          failOnMissingInput: false

          # A set of files and directory to include.
          #  
          includes:
            - 'name_or_regex'

          # A set of files and directory to exclude.
          #  
          excludes:
            - 'name_or_regex'

          # Additional properties used when evaluating templates.
          #  
          extraProperties:
            # Key will be capitalized and prefixed with `artifact`, i.e, `artifactFoo`.
            foo: bar

# Assemblers require a name.
# 
[assemble.nativeImage.app]

  # Enables or disables the assembler.
  # Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
  # Defaults to `NEVER`.
  #  
  active = "ALWAYS"

  # Export the assembled artifacts as a matching named distribution.
  # Defaults to `true`.
  # 
  exported = true

  # The stereotype of this assembler.
  # Supported values are [`NONE`, `CLI`, `DESKTOP`, `WEB`, `MOBILE`].
  # Defaults to `#{project.stereotype}`.
  # 
  stereotype = "CLI"

  # Additional properties used when evaluating templates.
  #  
  extraProperties.foo = "bar"
  # Key will be capitalized and prefixed with `nativeImage`, i.e, `nativeImageFoo`.

  # Key value pairs.
  # Keys match a full platform or an os.name, os.arch.
  # Same rules apply as in Platform.
  # 
  [assemble.nativeImage.app.platform.replacements]
    osx-x86_64 = "mac"
    aarch_64 = "aarch64"
    x86_64 = "amd64"
    linux_musl = "alpine"

  # Name of the executable launcher.
  # If left undefined, will use `#{assembler.name}`.
  # 
  executable = "app"

  # Name of the generated image.
  # If left undefined, will use
  # `#{assembler.executable}-#{project.version}`.
  # Generated artifacts always have the platform as suffix.
  #  
  imageName = "app-{{projectVersion}}"

  # Name transformation of the generated image.
  # Transformed artifacts always have the platform as suffix.
  #  
  imageNameTransform = "app-{{projectEffectiveVersion}}"

  # Archive format to use.
  # Supported values are [`ZIP`, `TAR`, `TAR_BZ2`, `TAR_GZ`, `TAR_XZ`, `TBZ2`, `TGZ`, `TXZ`].
  # Defaults to `ZIP`.
  # 
  archiveFormat = "TGZ"

  # List of Graal JDKs.
  #  
  graalJdks = [
    { path = "path/to/jdk", platform = "osx-x86_64" },
    { path = "path/to/jdk", platform = "linux-x86_64" }]

  # A list of build arguments.
  # The `-H:Name` argument will always be replaced with the
  # value of $executable.
  # 
  args = ["--install-exit-handlers"]

  # A list of additional GraalVM components to be installed.
  # 
  components = ["espresso"]

  # Compress the resulting executable with UPX.
  # 
  [assemble.nativeImage.app.upx]
    # Enables or disables UPX.
    # Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
    # Defaults to `NEVER`.
    # 
    active = "ALWAYS"

    # Tool version.
    # 
    version = "3.96"

    # A list of arguments.
    # 
    args = ["-f]

  # 
  [assemble.nativeImage.app.linux]
    # A list of arguments.
    # 
    args = ["--static]

  # 
  [assemble.nativeImage.app.windows]
    # A list of arguments.
    # 
    args = ["--foo]

  # 
  [assemble.nativeImage.app.osx]
    # A list of arguments.
    # 
    args = ["--bar]

  # Timestamp to use for each entry.
  # Must follow ISO-8601 +HH:MM timezone offset.
  # Example: 2023-03-08T12:56:33.024578+01:00
  # Defaults to timestamp for latest git commit or current time.
  # 
  options.timestamp = "2020-01-01T00:00:00.000000+00:00"

  # Set longFileMode for tar archives.
  # Possible values are [`ERROR`, `GNU`, `POSIX`, `TRUNCATE`].
  # Defaults to `ERROR`.
  # 
  options.longFileMode = "POSIX"

  # Set bigNumberMode for tar archives.
  # Possible values are [`ERROR`, `GNU`, `POSIX`].
  # Defaults to `ERROR`.
  # 
  options.bigNumberMode = "POSIX"

  # The executable JAR that contains the application.
  #  
  mainJar = { path = "path/to/app.jar" }

  # Defines a list of additional JARs as globs.
  # 
  [[assemble.jlink.app.jars]]
    # The pattern to use.
    # May use glob or regex pattern syntax.
    #  
    pattern = "path/to/**/*.jar"

  # Name of main module (if any).
  # Define only if the application is modular.
  # 
  java.mainModule = "com.acme.demo"

  # The application's entry point.
  # If left undefined, will use `#{project.java.mainClass}`.
  # 
  java.mainClass = "com.acme.Main"

  # Maven coordinates: groupId.
  # If left undefined, will use `#{project.java.groupId}`.
  # 
  java.groupId = "com.acme"

  # Maven coordinates: artifactId.
  # If left undefined, will use `#{project.java.artifactId}`.
  # 
  java.artifactId = "app"

  # The minimum Java version required by consumers to run the application.
  # If left undefined, will use `#{project.java.version}`.
  # 
  java.version = "8"

  # Identifies the project as being member of a multi-project build.
  # If left undefined, will use `#{project.java.multiProject}`.
  # 
  java.multiProject = false

  # Additional properties used when evaluating templates.
  # 
  java.extraProperties.foo = "bar"
  # Key will be capitalized and prefixed with `java`, i.e, `javaFoo`.

  # Directory with file templates used to prepare the assembler.
  # Defaults to `src/jreleaser/assemblers/#{distribution.name}/nativeImage`.
  # If specified, path must exist.
  # 
  templateDirectory = "path/to/nativeImage/templates"

  # List of template files to be skipped.
  # Value may be an exact match or a regex.
  # 
  skipTemplates = [ "README.md.tpl" ]

  # Defines a list of additional files as artifacts.
  # These files will be added to the assembled archive.
  #  
  [[assemble.nativeImage.app.artifacts]]
    path = "path/to/file"
  [[assemble.nativeImage.app.artifacts]]
    path = "path/to/another_file"
    transform = "path/inside/archive"
  [[assemble.nativeImage.app.artifacts]]
    path = "path/to/platform/specific/file"
    platform = "osx-x86_64"

  # Defines a list of additional files as globs.
  # These files will be added to the assembled archive.
  # 
  [[assemble.nativeImage.app.files]]
    # The pattern to use.
    # May use glob or regex pattern syntax.
    #  
    pattern = "path/to/**/*.txt"

  # Defines a list of additional files as filesets.
  # These files will be added to the assembled archive.
  # 
  [[assemble.nativeImage.app.fileSets]]
    # The input directory to copy files from.
    #  
    input = "path/to/input/directory"

    # The target path inside the archive.
    # If left undefined, defaults to the root of the archive.
    #  
    output = "path/to/archive/entry"

    # Fail if the given `input` does not exist.
    # Defaults to `true`.
    # 
    failOnMissingInput = false

    # A set of files and directory to include.
    #  
    includes = ["name_or_regex"]

    # A set of files and directory to exclude.
    #  
    excludes = ["name_or_regex"]

    # Additional properties used when evaluating templates.
    #  
    [[assemble.nativeImage.app.fileSets.extraProperties]]
      # Key will be capitalized and prefixed with `artifact`, i.e, `artifactFoo`.
      foo: bar

{
  // 
  "assemble": {
    // 
    "nativeImage": {
      // Assemblers require a name.
      // 
      "app": {

        // Enables or disables the assembler.
        // Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
        // Defaults to `NEVER`.
        //  
        "active": "ALWAYS",

        // Export the assembled artifacts as a matching named distribution.
        // Defaults to `true`.
        // 
        "exported": true,

        // The stereotype of this assembler.
        // Supported values are [`NONE`, `CLI`, `DESKTOP`, `WEB`, `MOBILE`].
        // Defaults to `#{project.stereotype}`.
        // 
        "stereotype": "CLI",

        // Additional properties used when evaluating templates.
        //  
        "extraProperties": {
          // Key will be capitalized and prefixed with `nativeImage`, i.e, `nativeImageFoo`.
          "foo": "bar"
        },

        // 
        platform: {
          // Key value pairs.
          // Keys match a full platform or an os.name, os.arch.
          // Same rules apply as in Platform.
          // 
          "replacements": {
            "osx-x86_64": "mac",
            "aarch_64": "aarch64",
            "x86_64": "amd64",
            "linux_musl": "alpine"
          }
        },

        // Name of the executable launcher.
        // If left undefined, will use `#{assembler.name}`.
        // 
        "executable": "app",

        // Name of the generated image.
        // If left undefined, will use
        // `#{assembler.executable}-#{project.version}`.
        // Generated artifacts always have the platform as suffix.
        //  
        "imageName": "app-{{projectVersion}}",

        // Name transformation of the generated image.
        // Transformed artifacts always have the platform as suffix.
        //  
        "imageNameTransform": "app-{{projectEffectiveVersion}}",

        // Archive format to use.
        // Supported values are [`ZIP`, `TAR`, `TAR_BZ2`, `TAR_GZ`, `TAR_XZ`, `TBZ2`, `TGZ`, `TXZ`].
        // Defaults to `ZIP`.
        // 
        "archiveFormat": "TGZ",

        // List of Graal JDKs.
        //  
        "graalJdks": [
          {
            "path": "path/to/jdk",
            "platform": "osx-x86_64"
          },
          {
            "path": "path/to/jdk",
            "platform": "linux-x86_64"
          }
        ],

        // A list of build arguments.
        // The `-H:Name` argument will always be replaced with the
        // value of $executable.
        // 
        "args": [
          "--install-exit-handlers"
        ],

        // A list of additional GraalVM components to be installed.
        // 
        "components": [
          "espresso"
        ],

        // Compress the resulting executable with UPX.
        // 
        "upx": {
          // Enables or disables UPX.
          // Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
          // Defaults to `NEVER`.
          // 
          "active": "ALWAYS",

          // Tool version.
          // 
          "version": "3.96",

          // A list of arguments.
          // 
          "args": ["-f"]
        },

        // 
        "linux": {
          // A list of arguments.
          // 
          "args": ["--static"]
        },

        // 
        "windows": {
          // A list of arguments.
          // 
          "args": ["--foo"]
        },

        // 
        "osx": {
          // A list of arguments.
          // 
          "args": ["--bar"]
        },

        // 
        "options": {
          // Timestamp to use for each entry.
          // Must follow ISO-8601 +HH:MM timezone offset.
          // Example: 2023-03-08T12:56:33.024578+01:00
          // Defaults to timestamp for latest git commit or current time.
          // 
          "timestamp": "2020-01-01T00:00:00.000000+00:00",

          // Set longFileMode for tar archives.
          // Possible values are [`ERROR`, `GNU`, `POSIX`, `TRUNCATE`].
          // Defaults to `ERROR`.
          // 
          "longFileMode": "POSIX",

          // Set bigNumberMode for tar archives.
          // Possible values are [`ERROR`, `GNU`, `POSIX`].
          // Defaults to `ERROR`.
          // 
          "bigNumberMode": "POSIX"
        },

        // The executable JAR that contains the application.
        //  
        "mainJar": {
          "path": "path/to/app.jar"
        },

        // Defines a list of additional JARs as globs.
        // 
        "jars": [
          {
            // The pattern to use.
            // May use glob or regex pattern syntax.
            //  
            "pattern": "path/to/**/*.jar"
          }
        ],

        // 
        "java": {
          // Name of main module (if any).
          // Define only if the application is modular.
          // 
          "mainModule": "com.acme.demo",

          // The application's entry point.
          // If left undefined, will use `#{project.java.mainClass}`.
          // 
          "mainClass": "com.acme.Main",

          // Maven coordinates: groupId.
          // If left undefined, will use `#{project.java.groupId}`.
          // 
          "groupId": "com.acme",

          // Maven coordinates: artifactId.
          // If left undefined, will use `#{project.java.artifactId}`.
          // 
          "artifactId": "app",

          // The minimum Java version required by consumers to run the application.
          // If left undefined, will use `#{project.java.version}`.
          // 
          "version": "8",

          // Identifies the project as being member of a multi-project build.
          // If left undefined, will use `#{project.java.multiProject}`.
          // 
          "multiProject": false,

          // Additional properties used when evaluating templates.
          // 
          "extraProperties": {
            // Key will be capitalized and prefixed with `java`, i.e, `javaFoo`.
            "foo": "bar"
          }
        },

        // Directory with file templates used to prepare the assembler.
        // Defaults to `src/jreleaser/assemblers/#$#{distribution.name}/nativeImage`.
        // If specified, path must exist.
        // 
        "templateDirectory": "path/to/nativeImage/templates",

        // List of template files to be skipped.
        // Value may be an exact match or a regex.
        // 
        "skipTemplates": [
          "README.md.tpl"
        ],

        // Defines a list of additional files as artifacts.
        // These files will be added to the assembled archive.
        //  
        "artifacts": [
          {
            "path": "path/to/file"
          },
          {
            "path": "path/to/another_file",
            "transform": "path/inside/archive"
          },
          {
            "path": "path/to/platform/specific/file",
            "platform": "osx-x86_64"
          }
        ]  ,

        // Defines a list of additional files as globs.
        // These files will be added to the assembled archive.
        // 
        "files": [
          {
            // The pattern to use.
            // May use glob or regex pattern syntax.
            //  
            "pattern": "path/to/**/*.txt"
          }
        ],

        // Defines a list of additional files as filesets.
        // These files will be added to the assembled archive.
        // 
        "fileSets": [
          {
            // The input directory to copy files from.
            //  
            "input": "path/to/input/directory",

            // The target path inside the archive.
            // If left undefined, defaults to the root of the archive.
            //  
            "output": "path/to/archive/entry",

            // Fail if the given `input` does not exist.
            // Defaults to `true`.
            // 
            "failOnMissingInput": false,

            // A set of files and directory to include.
            //  
            "includes": ["name_or_regex"],

            // A set of files and directory to exclude.
            //  
            "excludes": ["name_or_regex"],

            // Additional properties used when evaluating templates.
            //  
            "extraProperties": {
              // Key will be capitalized and prefixed with `artifact`, i.e, `artifactFoo`.
              "foo": "bar"
            }
          }
        ]
      }
    }
  }
}

<jreleaser>
  <!--
    
  -->
  <assemble>
    <!--
      
    -->
    <nativeImage>
      <!--
        Assemblers require a name.
        
      -->
      <app>
        <!--
          Enables or disables the distribution.
          Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
          Defaults to `ALWAYS`.
           
        -->
        <active>ALWAYS</active>

        <!--
          Export the assembled artifacts as a matching named distribution.
          Defaults to `true`.
          
        -->
        <exported>true</exported>

        <!--
          The stereotype of this assembler.
          Supported values are [`NONE`, `CLI`, `DESKTOP`, `WEB`, `MOBILE`].
          Defaults to `#{project.stereotype}`.
          
        -->
        <stereotype>CLI</stereotype>

        <!--
          Additional properties used when evaluating templates.
           
        -->
        <extraProperties>
          <!--
            Key will be capitalized and prefixed with `nativeImage`, i.e, `nativeImageFoo`.
          -->
          <foo>bar</foo>
        </extraProperties>

        <!--
          
        -->
        <platform>

          <!--
            Key value pairs.
            Keys match a full platform or an os.name, os.arch.
            Same rules apply as in Platform.
            
          -->
          <replacements>
            <osx-x86_64>mac</osx-x86_64>
            <aarch_64>aarch64</aarch_64>
            <x86_64>amd64</x86_64>
            <linux_musl>alpine</linux_musl>
          </replacements>
        </platform>

        <!--
          Name of the executable launcher.
          If left undefined, will use `#{assembler.name}`.
          
        -->
        <executable>app</executable>

        <!--
          Name of the generated image.
          If left undefined, will use
          `#{assembler.executable}-#{project.version}`.
          Generated artifacts always have the platform as suffix.
           
        -->
        <imageName>app-{{projectVersion}}</imageName>

        <!--
          Name transformation of the generated image.
          Transformed artifacts always have the platform as suffix.
           
        -->
        <imageNameTransform>app</imageNameTransform>

        <!--
          Archive format to use.
          Supported values are [`ZIP`, `TAR`, `TAR_BZ2`, `TAR_GZ`, `TAR_XZ`, `TBZ2`, `TGZ`, `TXZ`].
          Defaults to `ZIP`.
          
        -->
        <archiveFormat>TGZ</archiveFormat>

        <!--
          List of Graal JDKs.
           
        -->
        <graalJdks>
          <graalJdk>
            <path>path/to/jdk</path>
            <platform>osx-x86_64</platform>
          </graalJdk>
          <graalJdk>
            <path>path/to/jdk</path>
            <platform>linux-x86_64</platform>
          </graalJdk>
        </graalJdks>

        <!--
          A list of build arguments.
          The `-H =Name` argument will always be replaced with the
          value of $executable.
          
        -->
        <args>
          <arg>--install-exit-handlers</arg>
        </args>

        <!--
          A list of additional GraalVM components to be installed.
          
        -->
        <components>
          <component>espresso</component>
        <components>

        <!--
          Compress the resulting executable with UPX.
          
        --->
        <upx>
          <!--
            Enables or disables UPX.
            Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
            Defaults to `NEVER`.
            
          -->
          <active>ALWAYS</active>

          <!--
            Tool version.
            
          -->
          <version>3.96</version>

          <!--
            A list of arguments.
            
          -->
          <args>
            <arg>-f</arg>
          </args>
        </upx>

        <!--
          
        --->
        <linux>
          <!--
            A list of arguments.
            
          -->
          <args>
            <arg>--static</arg>
          </args>
        </linux>

        <!--
          
        --->
        <windows>
          <!--
            A list of arguments.
            
          -->
          <args>
            <arg>--foo</arg>
          </args>
        </windows>

        <!--
          
        --->
        <osx>
          <!--
            A list of arguments.
            
          -->
          <args>
            <arg>--bar</arg>
          </args>
        </osx>

        <!--
          
        -->
        <options>
          <!--
            Timestamp to use for each entry.
            Must follow ISO-8601 +HH:MM timezone offset.
            Example: 2023-03-08T12:56:33.024578+01:00
            Defaults to timestamp for latest git commit or current time.
            
          -->
          <timestamp>2020-01-01T00:00:00.000000+00:00</timestamp>

          <!--
            Set longFileMode for tar archives.
            Possible values are [`ERROR`, `GNU`, `POSIX`, `TRUNCATE`].
            Defaults to `ERROR`.
            
          -->
          <longFileMode>POSIX</longFileMode>

          <!--
            Set bigNumberMode for tar archives.
            Possible values are [`ERROR`, `GNU`, `POSIX`].
            Defaults to `ERROR`.
            
          -->
          <bigNumberMode>POSIX</bigNumberMode>
        </options>

        <!--
          The executable JAR that contains the application.
           
        -->
        <mainJar>
          <path>path/to/app.jar</path>
        </mainJar>

        <!--
          Defines a list of additional JARs as globs.
          
        -->
        <jars>
          <jar>
            <!--
              The pattern to use.
              May use glob or regex pattern syntax.
               
            -->
            <pattern>path/to/**/*.jar</pattern>
          </jar>
        </jars>

        <!--
          
        -->
        <java>
          <!--
            Name of main module (if any).
            Define only if the application is modular.
            
          -->
          <mainModule>com.acme.demo</mainModule>

          <!--
            The application's entry point.
            If left undefined, will use `#{project.java.mainClass}`.
            
          -->
          <mainClass>com.acme.Main</mainClass>

          <!--
            Maven coordinates>groupId.
            If left undefined, will use `#{project.java.groupId}`.
            
          -->
          <groupId>com.acme</groupId>

          <!--
            Maven coordinates>artifactId.
            If left undefined, will use `#{project.java.artifactId}`.
            
          -->
          <artifactId>app</artifactId>

          <!--
            The minimum Java version required by consumers to run the application.
            If left undefined, will use `#{project.java.version}`.
            
          -->
          <version>8</version>

          <!--
            Identifies the project as being member of a multi-project build.
            If left undefined, will use `#{project.java.multiProject}`.
            
          -->
          <multiProject>false</multiProject>

          <!--
            Additional properties used when evaluating templates.
            
          -->
          <extraProperties>
            <!--
              Key will be capitalized and prefixed with `java`, i.e, `javaFoo`.
            -->
            <foo>bar</foo>
          </extraProperties>
        </java>

        <!--
          Directory with file templates used to prepare the assembler.
          Defaults to `src/jreleaser/assemblers/#{distribution.name}/nativeImage`.
          If specified, path must exist.
          
        -->
        <templateDirectory>path/to/nativeImage/templates</templateDirectory>

        <!--
          List of template files to be skipped.
          Value may be an exact match or a regex.
          
        -->
        <skipTemplates>
          <skipTemplate>README.md.tpl</skipTemplate>
        </skipTemplates>

        <!--
          Defines a list of additional files as artifacts.
          These files will be added to the assembled archive.
           
        -->
        <artifacts>
          <artifact>
            <path>path/to/file</path>
          </artifact>
          <artifact>
            <path>path/to/another_file</path>
            <transform>path/inside/archive</transform>
          </artifact>
          <artifact>
            <path>path/to/platform/specific/file</path>
            <platform>osx-x86_64</platform>
          </artifact>
        </artifacts>

        <!--
          Defines a list of additional files as globs.
          These files will be added to the assembled archive.
          
        -->
        <files>
          <file>
            <!--
              The pattern to use.
              May use glob or regex pattern syntax.
               
            -->
            <pattern>path/to/**/*.txt</pattern>
          </file>
        </files>

        <!--
          Defines a list of additional files as filesets.
          These files will be added to the assembled archive.
          
        -->
        <fileSets>
          <fileSet>
            <!--
              The input directory to copy files from.
               
            -->
            <input>path/to/input/directory</input>

            <!--
              The target path inside the archive.
              If left undefined, defaults to the root of the archive.
               
            -->
            <output>path/to/archive/entry</output>

            <!--
              Fail if the given `input` does not exist.
              Defaults to `true`.
              
            -->
            <failOnMissingInput>false</failOnMissingInput>

            <!--
              A set of files and directory to include.
               
            -->
            <includes>
              <include>name_or_regex</include>
            </includes>

            <!--
              A set of files and directory to exclude.
               
            -->
            <excludes>
              <exclude>name_or_regex</exclude>
            </excludes>

            <!--
              Additional properties used when evaluating templates.
              
            -->
            <extraProperties>
              <!--
                Key will be capitalized and prefixed with `artifact`, i.e, `artifactFoo`.
              -->
              <foo>bar</foo>
            </extraProperties>
          </fileSet>
        </fileSets>
      </app>
    </nativeImage>
  </assemble>
</jreleaser>

jreleaser {
  // 
  assemble {
    // 
    nativeImage {
      // Assemblers require a name.
      // 
      app {

        // Enables or disables the assembler.
        // Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
        // Defaults to `NEVER`.
        //  
        active = 'ALWAYS'

        // Export the assembled artifacts as a matching named distribution.
        // Defaults to `true`.
        // 
        exported = true

        // The stereotype of this assembler.
        // Supported values are [`NONE`, `CLI`, `DESKTOP`, `WEB`, `MOBILE`].
        // Defaults to `#{project.stereotype}`.
        // 
        stereotype = 'CLI'

        // Additional properties used when evaluating templates.
        // Key will be capitalized and prefixed with `nativeImage`, i.e, `nativeImageFoo`.
        //  
        extraProperties.put('foo', 'bar')

        // 
        platform {

          // Key value pairs.
          // Keys match a full platform or an os.name, os.arch.
          // Same rules apply as in Platform.
          // 
          replacements = [
            'osx-x86_64': 'mac',
            aarch_64: 'aarch64',
            x86_64: 'amd64',
            linux_musl: 'alpine'
          ]
        }

        // Name of the executable launcher.
        // If left undefined, will use `#{assembler.name}`.
        // 
        executable = 'app'

        // Name of the generated image.
        // If left undefined, will use
        // `#{assembler.executable}-#{project.version}`.
        // Generated artifacts always have the platform as suffix.
        //  
        imageName = 'app-{{projectVersion}}'

        // Name transformation of the generated image.
        // Transformed artifacts always have the platform as suffix.
        //  
        imageNameTransform = 'app-{{projectEffectiveVersion}}'

        // Archive format to use.
        // Supported values are [`ZIP`, `TAR`, `TAR_BZ2`, `TAR_GZ`, `TAR_XZ`, `TBZ2`, `TGZ`, `TXZ`].
        // Defaults to `ZIP`.
        // 
        archiveFormat = 'TGZ'

        // List of Graal JDKs.
        //  
        graalJdk {
          path = 'path/to/jdk'
          platform = 'osx-x86_64'
        }
        graalJdk {
          path = 'path/to/jdk'
          platform = 'linux-x86_64'
        }

        // A list of build arguments.
        // The `-H =Name` argument will always be replaced with the
        // value of $executable.
        // 
        arg('--install-exit-handlers')

        // A list of additional GraalVM components to be installed.
        // 
        component('espresso')

        // Compress the resulting executable with UPX.
        // 
        upx {
          // Enables or disables UPX.
          // Supported values are [`NEVER`, `ALWAYS`, `RELEASE`, `SNAPSHOT`].
          // Defaults to `NEVER`.
          // 
          active = 'ALWAYS'

          // Tool version.
          // 
          version = '3.96'

          // A list of arguments.
          // 
          arg('-f')
        }

        // 
        linux {
          // A list of arguments.
          // 
          arg('--static')
        }

        // 
        windows {
          // A list of arguments.
          // 
          arg('--foo')
        }

        // 
        osx {
          // A list of arguments.
          // 
          arg('--bar')
        }

        // 
        options {
          // Timestamp to use for each entry.
          // Must follow ISO-8601 + timezone offset.
          // Example: 2023-03-08T12:56:33.024578+01:00
          // Defaults to timestamp for latest git commit or current time.
          // 
          timestamp = '2020-01-01T00:00:00.000000+00:00'

          // Set longFileMode for tar archives.
          // Possible values are [`ERROR`, `GNU`, `POSIX`, `TRUNCATE`].
          // Defaults to `ERROR`.
          // 
          longFileMode = 'POSIX'

          // Set bigNumberMode for tar archives.
          // Possible values are [`ERROR`, `GNU`, `POSIX`].
          // Defaults to `ERROR`.
          // 
          bigNumberMode = 'POSIX'
        }

        // The executable JAR that contains the application.
        //  
        mainJar {
          path = 'path/to/app.jar'
        }

        // Defines a list of additional JARs as globs.
        // 
        jars {
          // The pattern to use.
          // May use glob or regex pattern syntax.
          //  
          pattern = 'path/to/**/*.jar'
        }

        // 
        java {
          // Name of main module (if any).
          // Define only if the application is modular.
          // 
          mainModule = 'com.acme.demo'

          // The application's entry point.
          // If left undefined, will use `#{project.java.mainClass}`.
          // 
          mainClass = 'com.acme.Main'

          // Maven coordinates = groupId.
          // If left undefined, will use `#{project.java.groupId}`.
          // 
          groupId = 'com.acme'

          // Maven coordinates = artifactId.
          // If left undefined, will use `#{project.java.artifactId}`.
          // 
          artifactId = 'app'

          // The minimum Java version required by consumers to run the application.
          // If left undefined, will use `#{project.java.version}`.
          // 
          version = '8'

          // Identifies the project as being member of a multi-project build.
          // If left undefined, will use `#{project.java.multiProject}`.
          // 
          multiProject = false

          // Additional properties used when evaluating templates.
          // Key will be capitalized and prefixed with `java`, i.e, `javaFoo`.
          // 
          extraProperties.put('foo', 'bar')
        }

        // Directory with file templates used to prepare the assembler.
        // Defaults to `src/jreleaser/assemblers/#{distribution.name}/nativeImage`.
        // If specified, path must exist.
        // 
        templateDirectory = 'path/to/nativeImage/templates'

        // List of template files to be skipped.
        // Value may be an exact match or a regex.
        // 
        skipTemplate('README.md.tpl')

        // Defines a list of additional files as artifacts.
        // These files will be added to the assembled archive.
        //  
        artifact {
          path = 'path/to/file'
        }
        artifact {
          path = 'path/to/another_file'
          transform = 'path/inside/archive'
        }
        artifact {
          path = 'path/to/platform/specific/file'
          platform = 'osx-x86_64'
        }

        // Defines a list of additional files as globs.
        // These files will be added to the assembled archive.
        // 
        files {
          // The pattern to use.
          // May use glob or regex pattern syntax.
          //  
          pattern = 'path/to/**/*.txt'
        }

        // Defines a list of additional files as filesets.
        // These files will be added to the assembled archive.
        // 
        fileSet {
          // The input directory to copy files from.
          //  
          input = 'path/to/input/directory'

          // The target path inside the archive.
          // If left undefined, defaults to the root of the archive.
          //  
          output = 'path/to/archive/entry'

          // Fail if the given `input` does not exist.
          // Defaults to `true`.
          // 
          failOnMissingInput = false

          // A set of files and directory to include.
          //  
          includes = ['name_or_regex']

          // A set of files and directory to exclude.
          //  
          excludes = ['name_or_regex']

          // Additional properties used when evaluating templates.
          // Key will be capitalized and prefixed with `artifact`, i.e, `artifactFoo`.
          //  
          extraProperties.put('foo', 'bar')
        }
      }
    }
  }
}

Environment

When not explicitly set, the value of the following properties may be resolved from an environment variable or a system property as shown in the table. The system property takes precedence over the environment variable.

System Property	Environment Variable
active
jreleaser.assemble.native.image.${name}.active jreleaser.assemble.native.image.active	JRELEASER_ASSEMBLE_NATIVE_IMAGE_${name}_ACTIVE JRELEASER_ASSEMBLE_NATIVE_IMAGE_ACTIVE

System Property

Environment Variable

active

jreleaser.assemble.native.image.${name}.active
jreleaser.assemble.native.image.active

JRELEASER_ASSEMBLE_NATIVE_IMAGE_${name}_ACTIVE
JRELEASER_ASSEMBLE_NATIVE_IMAGE_ACTIVE

Substitute ${name} for the value of the named instance.

Space (' '), underscore (_), and dash (-) will be replaced by dot (.) to separate tokens in the System property. Space (' '), dash (-), and dot (.) will be replaced by underscore (_) to separate tokens in the environment variable, such that:

${name} System Property Environment Variable

${name}	System Property	Environment Variable
foobar	`foobar`	`FOOBAR`
fooBar	`foobar`	`FOOBAR`
foo bar	`foo.bar`	`FOO_BAR`
foo-bar	`foo.bar`	`FOO_BAR`
foo_bar	`foo.bar`	`FOO_BAR`
foo.bar	`foo.bar`	`FOO_BAR`

foobar

foobar

FOOBAR

fooBar

foobar

FOOBAR

foo bar

foo.bar

FOO_BAR

foo-bar

foo.bar

FOO_BAR

foo_bar

foo.bar

FOO_BAR

foo.bar

foo.bar

FOO_BAR

Graal JDKs

The following rules apply when resolving which Graal JDK will be used to generate native image executables:

A matching JDK (by platform) will be searched in graalJdks.
If no match is found then the currently executing JDK will be used.

Paths for graalJdks must exist in the file system. You may use the jdks-maven-plugin or jdks-gradle-plugin to download required JDKs.

UPX

Executables may optionally be compressed with UPX. You must define a version. JReleaser will check if a matching binary exists in the system or download a binary that matches the current platform.

Templates

The default location for templates is:

src/jreleaser/assemblers/<distribution-name>/nativeImage

Any additional files found in the template directories will be copied as is unless their filename ends with .tpl in which case Name Templates substitution will take place.

Skip Templates

You may skip any template files by defining a set of skip rules in the skipTemplates property. For example, you may use any of these expressions to skip a template named README.md.tpl:

README.md.tpl: matches the full template name
README.md: matches the transformed template name
README.*: matches using a regex

Additional Files

There are several ways to define additional files that may be handled by this assembler.

Templates

You may use Name Templates inside the files to be copied.
They retain directory structure that is, a template found at {templateDirectory}/foo.txt.tpl will be copied as foo.txt while a template such as {templateDirectory}/docs/bar.md.tpl will be copied to docs/bar.md.

FileSets

May use globs or regexes to define files to be included from a starting directory.
They retain directory structure.
May rename the target parent directory.

Files

May use globs or regexes to define files to be included from a starting directory.
They do not retain directory structure. Only filenames are copied.

Artifacts

They do not retain directory structure by default. An artifact with path set to bin/launcher.sh will be copied to launcher.sh.
May use the transform property to define the target path. An artifact with path set to bin/launcher.sh and transform set to bin/{{projectName}} will be copied to bin/app [assuming projectName resolves to app].
May use the platform property to filter files per matching platform. An artifact with platform set to windows-x86_64 will only be copied when the matching platform is compatible with windows-x86_64.
Artifacts without an explicit platform won’t be filtered.