{"id":229,"date":"2026-10-12T23:41:05","date_gmt":"2026-10-12T23:41:05","guid":{"rendered":"http:\/\/www.scmgalaxy.com\/tutorials\/2010\/04\/14\/usage-of-ant_opts-in-ant-script-ant_opts-capabilities\/"},"modified":"2026-10-12T23:41:05","modified_gmt":"2026-10-12T23:41:05","slug":"usage-of-ant_opts-in-ant-script-ant_opts-capabilities","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/usage-of-ant_opts-in-ant-script-ant_opts-capabilities\/","title":{"rendered":"ANT_OPTS in Apache Ant: JVM Memory, Proxy Settings, and Startup Troubleshooting"},"content":{"rendered":"\n

Apache Ant can be tuned before any build runs by setting environment variables. This guide is for build and DevOps engineers who want predictable Ant behavior across local machines and CI runners, and it covers exactly how ANT_OPTS<\/code>, ANT_ARGS<\/code>, and JAVACMD<\/code> are used.<\/p>\n\n\n\n

Originally published on 2010-04-14; fully revised and updated.<\/em><\/p>\n\n\n\n

Source context: Usage of ANT_OPTS in Ant Script | ANT_OPTS capabilities<\/a>.<\/p>\n\n\n\n

\"ANT_OPTS<\/figure>\n\n\n\n

What ANT_OPTS, ANT_ARGS, and JAVACMD do<\/h2>\n\n\n\n

Ant launcher scripts read environment variables and then start Java + Ant with those settings. The most useful variables are shown below.<\/p>\n\n\n\n

Variable<\/th>What it affects<\/th>Typical value examples<\/th>Best use<\/th><\/tr><\/thead>
ANT_OPTS<\/td>JVM options for the Java process running Ant<\/td>-Xmx1024m, -Dlog.dir=\/var\/log\/build<\/td>Heap tuning and JVM system properties<\/td><\/tr>
ANT_ARGS<\/td>Default Ant command-line options<\/td>-verbose, -lib \/opt\/ant\/lib<\/td>Repeated Ant CLI flags<\/td><\/tr>
JAVACMD<\/td>Java executable Ant should run<\/td>\/path\/to\/java<\/td>Force a specific JVM\/JDK binary<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

Runtime flow when you execute an Ant build<\/h2>\n\n\n\n

This is the high-level startup path that explains where each variable is applied.<\/p>\n\n\n\n

\nflowchart TD\n    A[Set ANT_OPTS ANT_ARGS JAVACMD] --> B[Run ant command]\n    B --> C[Launcher script selects Java binary]\n    C --> D[Start JVM with ANT_OPTS]\n    D --> E[Ant reads ANT_ARGS and CLI args]\n    E --> F{Arguments valid}\n    F -- no --> G[Startup error and exit]\n    F -- yes --> H[Execute requested target]\n<\/pre>\n\n\n\n
Common ANT_OPTS use cases<\/h2>\n\n\n\n
Set JVM heap for larger builds<\/h3>\n\n\n\n
If dependency resolution, compilation, or large XML processing causes memory pressure, increase heap via ANT_OPTS<\/code>.<\/p>\n\n\n
# Windows CMD<\/span>\nset ANT_OPTS=-Xms256m -Xmx1024m\nant clean compile\n\n# Linux\/macOS shell<\/span>\nexport ANT_OPTS=\"-Xms256m -Xmx1024m\"<\/span>\nant clean compile<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Pass JVM system properties into Ant builds<\/h3>\n\n\n\n
A common pattern is passing build-time properties through the JVM so the Ant build file can consume them.<\/p>\n\n\n
# Windows CMD<\/span>\nset ANT_OPTS=-Dlog.dir=C:\\logs\nant run\n\n# Linux\/macOS shell<\/span>\nexport ANT_OPTS=\"-Dlog.dir=\/var\/log\/myapp\"<\/span>\nant run<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n
<project<\/span> name<\/span>=\"demo\"<\/span> default<\/span>=\"show-log-dir\"<\/span>><\/span>\n  <target<\/span> name<\/span>=\"show-log-dir\"<\/span>><\/span>\n    <echo<\/span>><\/span>Log directory is set to: ${log.dir}<\/echo<\/span>><\/span>\n  <\/target<\/span>><\/span>\n<\/project<\/span>><\/span><\/code><\/span>Code language:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
Configure proxy settings for dependency downloads<\/h3>\n\n\n\n
You can pass HTTP\/HTTPS proxy host and port as JVM properties when Ant must reach external repositories through a corporate proxy.<\/p>\n\n\n
# Windows CMD<\/span>\nset ANT_OPTS=-Dhttp.proxyHost=myproxy -Dhttp.proxyPort=3128<\/span> -Dhttps.proxyHost=myproxy -Dhttps.proxyPort=3128<\/span>\nant mytarget\n\n# Linux\/macOS shell<\/span>\nexport ANT_OPTS=\"-Dhttp.proxyHost=myproxy -Dhttp.proxyPort=3128 -Dhttps.proxyHost=myproxy -Dhttps.proxyPort=3128\"<\/span>\nant mytarget<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
Troubleshooting invalid ANT_OPTS values<\/h2>\n\n\n\n
If ANT_OPTS<\/code> contains invalid JVM arguments, Ant may fail before your build starts.<\/p>\n\n\n\n
  • Symptom 1:<\/strong> Unrecognized option<\/code> and JVM startup failure.<\/li>
  • Symptom 2:<\/strong> NoClassDefFoundError<\/code> if a malformed token is interpreted as a class name.<\/li>
  • Check:<\/strong> Print the current variable and confirm every token is a valid JVM option.<\/li>
  • Fix:<\/strong> Correct or clear ANT_OPTS<\/code> and run Ant again.<\/li><\/ul>\n\n\n
    # Inspect current value<\/span>\n# Windows CMD<\/span>\necho<\/span> %ANT_OPTS%\n\n# Linux\/macOS shell<\/span>\necho<\/span> \"$ANT_OPTS\"<\/span>\n\n# Clear and retest<\/span>\n# Windows CMD<\/span>\nset ANT_OPTS=\nant -version\n\n# Linux\/macOS shell<\/span>\nunset<\/span> ANT_OPTS\nant -version<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n
    Unrecognized<\/span> option<\/span>: -3<\/span>\nCould<\/span> not<\/span> create<\/span> the<\/span> Java<\/span> virtual<\/span> machine<\/span>.\n\nException<\/span> in<\/span> thread<\/span> \"main<\/span>\" java<\/span>.lang<\/span>.NoClassDefFoundError<\/span>: error-string<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    Best practices and common pitfalls<\/h2>\n\n\n\n
    • Use ANT_OPTS<\/code> only for JVM<\/strong> flags (memory, -D<\/code> properties, GC\/JVM options).<\/li>
    • Use ANT_ARGS<\/code> for repeated Ant CLI<\/strong> flags, not JVM flags.<\/li>
    • Use JAVACMD<\/code> when you must pin Ant to a specific Java binary.<\/li>
    • Avoid storing proxy credentials in plain text environment variables when possible; prefer CI secret management.<\/li>
    • Document team-standard settings in build scripts or CI configuration to reduce machine-to-machine drift.<\/li><\/ul>\n","protected":false},"excerpt":{"rendered":"
      ANT_OPTS passes JVM options to the Java process that runs Ant. This guide explains how ANT_OPTS differs from ANT_ARGS and JAVACMD, with practical examples for memory tuning, proxy setup, and startup error diagnosis.<\/p>\n","protected":false},"author":1,"featured_media":4239,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[12],"tags":[209,3795,3799,3801,3797,3798,3045,683,3796,3800,1122,3802,1806,938,213,3794],"class_list":["post-229","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-apache-ant","tag-ant","tag-ant-opts","tag-ant-opts-capabilities","tag-ant-opts-in-ant-script","tag-ant-opts-usage","tag-ant-opts-usage-in-ant-script","tag-ant-script","tag-apache-ant","tag-capabilities","tag-capabilities-of-ant-opts","tag-guide","tag-how-to-use-ant-opts-in-ant-script","tag-instruction","tag-reference","tag-tutorial","tag-usage"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/229","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=229"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/229\/revisions"}],"predecessor-version":[{"id":79059,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/229\/revisions\/79059"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media\/4239"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=229"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=229"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=229"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}