blob: 9a150236b8e4cf9b680c0794b2fc1747fd4c3217 [file] [log] [blame]
<!doctype html>
<!-- Generated by FreeMarker/Docgen from DocBook -->
<html lang="en" class="page-type-chapter">
<head prefix="og: http://ogp.me/ns#">
<meta charset="utf-8">
<title>Download / Maven - Apache FreeMarker™</title>
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="format-detection" content="telephone=no">
<meta property="og:site_name" content="Apache FreeMarker™">
<meta property="og:title" content="Download / Maven">
<meta property="og:locale" content="en_US">
<meta property="og:url" content="https://freemarker.apache.org/freemarkerdownload.html">
<link rel="canonical" href="https://freemarker.apache.org/freemarkerdownload.html">
<link rel="icon" href="favicon.png" type="image/png">
<link rel="stylesheet" type="text/css" href="https://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1707809060700">
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/cookie-bar/cookiebar-latest.min.js"></script>
</head>
<body itemscope itemtype="https://schema.org/Code">
<meta itemprop="url" content="https://freemarker.apache.org/">
<meta itemprop="name" content="Apache FreeMarker™">
<!--[if lte IE 9]>
<div class="oldBrowserWarning" style="display: block">
Unsupported web browser - Use a modern browser to view this website!
</div>
<![endif]--> <div class="oldBrowserWarning">
Unsupported web browser - Use a modern browser to view this website!
</div>
<div class="header-top-bg"><div class="site-width header-top"><div id="hamburger-menu" role="button"></div> <div class="logo">
<a href="https://freemarker.apache.org/" role="banner"><img itemprop="image" src="logo.png" alt="FreeMarker"></a> </div>
<ul class="tabs"><li class="current"><a href="index.html">Home</a></li><li><a href="docs/index.html">Manual</a></li><li><a class="external" href="docs/api/index.html">Java API</a></li></ul><ul class="secondary-tabs"><li><a class="tab icon-heart" href="contribute.html" title="Contribute"><span>Contribute</span></a></li><li><a class="tab icon-bug" href="https://issues.apache.org/jira/projects/FREEMARKER" title="Report a Bug"><span>Report a Bug</span></a></li><li><a class="tab icon-download" href="freemarkerdownload.html" title="Download"><span>Download</span></a></li></ul></div></div> <div class="main-content site-width">
<div class="content-wrapper">
<div id="table-of-contents-wrapper" class="col-left">
<script>var breadcrumb = ["Apache FreeMarker™","Download / Maven"];</script>
<script src="toc.js?1707809060700"></script>
<script src="docgen-resources/main.min.js?1707809060700"></script>
<div class="side-toc-logos">
<div class="side-toc-logo">
<a href="https://www.apache.org/events/current-event.html" target="_blank"><img src="https://www.apache.org/events/current-event-234x60.png" alt="Apache Incubator" /></a>
</div>
</div>
</div>
<div class="col-right"><div class="page-content"><div class="page-title"><div class="title-wrapper">
<h1 class="content-header header-chapter" id="freemarkerdownload" itemprop="headline">Download / Maven</h1>
</div></div><p>Apache FreeMarker is a template engine: a Java library to generate
text output (HTML web pages, e-mails, configuration files, source code,
etc.) based on templates and changing data.</p><p><strong>Dependencies:</strong> FreeMarker has no
required dependencies, except Java (Standard Edition) itself, with the
minimum version indicated for each download below.</p><p><strong>Backward compatibility:</strong> Before
2.3.0 (2004), releases with different second version numbers (like 2.2.x
and 2.3.x) aren&#39;t fully compatible. The 2.3.x series is quite conservative
about backward compatibility; you should be able to replace the FreeMarker
binary (<code class="inline-code">freemarker.jar</code>) under your application with a
newer one without breaking anything (obviously, assuming that only public
FreeMarker API-s were used).</p><p><strong>Change log (version history):</strong>
<a href="docs/app_versions.html">See in the Manual...</a></p><p><strong>Verifying downloads:</strong> When
downloading from a mirror please check the checksum and verify the OpenPGP
compatible signature specified next to the download link (MD5, SHA256 and
ASC files, all must come from the <a href="https://www.apache.org/">www.apache.org</a> domain). The
public keys used for signing are here: <a href="https://www.apache.org/dist/freemarker/KEYS">KEYS</a> (also
must come from www.apache.org). <a href="https://www.apache.org/dyn/closer.cgi#verify">More about how
to verify releases...</a> Note that such verification is only possible
since 2.3.24.</p>
<h2 class="content-header header-simplesect" id="autoid_4">Latest stable release: 2.3.32</h2>
<p>Released on 2023-01-14. Requires J2SE 1.7 or higher.</p>
<p><a href="https://freemarker.apache.org/docs/versions_2_3_32.html">See
what&#39;s new...</a></p>
<p>Downloads:</p>
<ul>
<li>
<p><a href="https://www.apache.org/dyn/closer.cgi/freemarker/engine/2.3.32/binaries/apache-freemarker-2.3.32-bin.tar.gz">Binary
release (tar.gz)</a> (includes <code class="inline-code">freemarker.jar</code>
and documentation) [<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/binaries/apache-freemarker-2.3.32-bin.tar.gz.sha512">SHA512</a>]
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/binaries/apache-freemarker-2.3.32-bin.tar.gz.asc">ASC</a>]</p>
</li>
<li>
<p><a href="https://www.apache.org/dyn/closer.cgi/freemarker/engine/2.3.32/source/apache-freemarker-2.3.32-src.tar.gz">Source
release (tar.gz)</a> [<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/source/apache-freemarker-2.3.32-src.tar.gz.sha512">SHA512</a>]
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/source/apache-freemarker-2.3.32-src.tar.gz.asc">ASC</a>]</p>
</li>
</ul>
<p>For Maven:</p>
<div class="code-block role-unspecified">
<pre class="code-block-body">&lt;!--
Attention: Be sure nothing pulls in an old dependency with groupId
&quot;freemarker&quot; (without the &quot;org.&quot;), because then you will end up with
two freemarker.jar-s and unpredictable behavior!
--&gt;
&lt;dependency&gt;
&lt;groupId&gt;org.freemarker&lt;/groupId&gt;
&lt;artifactId&gt;freemarker&lt;/artifactId&gt;
&lt;version&gt;2.3.32&lt;/version&gt;
&lt;/dependency&gt;</pre> </div>
<div class="callout note">
<strong class="callout-label">Note:</strong>
<p>Until about 2007 the Maven group name was
"freemarker" instead of "org.freemarker",
and as the XML comment above says, this can cause problems, as Maven
will see them as two independent artifacts with no version conflict.
If you run into this issue, find the <code class="inline-code">dependency</code>
that depends on the old FreeMarker, and insert
<code class="inline-code">&lt;exclusions&gt;&lt;exclusion&gt;&lt;groupId&gt;freemarker&lt;!--
Legacy org-less group
--&gt;&lt;/groupId&gt;&lt;artifactId&gt;freemarker&lt;/artifactId&gt;
&lt;/exclusion&gt;&lt;/exclusions&gt;</code> into it.</p>
</div>
<p>There&#39;s also a separate Google App Engine compatible
("gae") variation. Download: <a href="https://www.apache.org/dyn/closer.cgi/freemarker/engine/2.3.32/binaries/apache-freemarker-gae-2.3.32-bin.tar.gz">binary</a>
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/binaries/apache-freemarker-gae-2.3.32-bin.tar.gz.sha512">SHA512</a>]
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/binaries/apache-freemarker-gae-2.3.32-bin.tar.gz.asc">ASC</a>],
<a href="https://www.apache.org/dyn/closer.cgi/freemarker/engine/2.3.32/source/apache-freemarker-gae-2.3.32-src.tar.gz">source</a>
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/source/apache-freemarker-gae-2.3.32-src.tar.gz.sha512">SHA512</a>]
[<a href="https://www.apache.org/dist/freemarker/engine/2.3.32/source/apache-freemarker-gae-2.3.32-src.tar.gz.asc">ASC</a>].
Maven:</p>
<div class="code-block role-unspecified">
<pre class="code-block-body">&lt;dependency&gt;
&lt;groupId&gt;org.freemarker&lt;/groupId&gt;
&lt;artifactId&gt;freemarker-gae&lt;/artifactId&gt;
&lt;version&gt;2.3.32&lt;/version&gt;
&lt;/dependency&gt;</pre> </div>
<h2 class="content-header header-simplesect" id="autoid_5">Old versions</h2>
<p>Old 2.x versions starting from 2.3.24 RC01 (and higher) are
available from the Apache archive: <a href="https://archive.apache.org/dist/incubator/freemarker/engine/">https://archive.apache.org/dist/freemarker/engine/</a>.</p>
<p>Even older versions, <strong>which weren&#39;t yet
coming from Apache</strong>:</p>
<ul>
<li>
<p>2.3.x versions before 2.3.24 RC01 are available from the <a href="https://sourceforge.net/projects/freemarker/files/freemarker/">SourceForge
download page</a>.</p>
</li>
<li>
<p>2.2.8: Released on 2004-06-15. This is the latest stable
release of the 2.2 series. Requires J2SE 1.2 or higher. <a href="https://prdownloads.sourceforge.net/freemarker/freemarker-2.2.8.tar.gz">Download
freemarker-2.2.8.tar.gz</a> (1.4 MB)</p>
</li>
<li>
<p>2.1.5: Released on 2003-02-08. This is the latest stable
release of the 2.1 series. Requires J2SE 1.3 or higher. <a href="https://prdownloads.sourceforge.net/freemarker/freemarker-2.1.5.tar.gz">Download
freemarker-2.1.5.tar.gz</a> (909 KB)</p>
</li>
<li>
<p>2.0.3 (aka. 2.03): Released on 2002-06-12. The latest stable
release of the 2.0 series. Requires J2SE 1.2 or higher. <a href="https://prdownloads.sourceforge.net/freemarker/freemarker2_03.tar.gz">Download
freemarker2_03.tar.gz</a> (617 KB)</p>
</li>
<li>
<p>1.x: The FreeMarker 1.x branch continues as separate project,
called FreeMarker Classic. See releases on the <a href="http://fm-classic.sourceforge.net/">FreeMarker Classic
homepage</a>!</p>
</li>
</ul>
</div></div> </div>
</div>
<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="index.html">What is FreeMarker?</a></li><li><a href="freemarkerdownload.html">Download</a></li><li><a href="docs/app_versions.html">Version history</a></li><li><a href="docs/app_faq.html">FAQ</a></li><li><a itemprop="license" href="docs/app_license.html">License</a></li><li><a href="https://privacy.apache.org/policies/privacy-policy-public.html">Privacy policy</a></li></ul></div><div class="column"><h3 class="column-header">Often used / Reference</h3><ul><li><a href="https://try.freemarker.apache.org/">Try template online</a></li><li><a href="docs/dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="docs/ref_directive_alphaidx.html">#directives</a></li><li><a href="docs/ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="docs/ref_specvar.html">.special_vars</a></li><li><a href="docs/api/freemarker/core/Configurable.html#setSetting-java.lang.String-java.lang.String-">Configuration settings</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href="https://github.com/apache/freemarker">Github project page</a></li><li><a href="https://issues.apache.org/jira/projects/FREEMARKER">Report a bug</a></li><li><a href="report-security-vulnerabilities.html">Report security vulnerability</a></li><li><a href="https://stackoverflow.com/questions/ask?tags=freemarker">Get help on StackOverflow</a></li><li><a href="https://twitter.com/freemarker">Announcements on Twitter</a></li><li><a href="mailing-lists.html">Discuss on mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/apache/freemarker">GitHub</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="https://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
Last generated:
<time itemprop="dateModified" datetime="2024-02-13T07:24:20Z" title="Tuesday, February 13, 2024 at 7:24:20 AM Greenwich Mean Time">2024-02-13 07:24:20 GMT</time> </p>
<p class="copyright">
© <span itemprop="copyrightYear">1999</span>–2024
<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. </p>
</div></div></div></body>
</html>