Foswiki archived release

alert This release is superseded by Foswiki 2.1.7. Visit the download page.

See Release Dates for the complete list of available releases.

Highlights of this maintenance release

  • Contains 58 fixes relative to 2.1.0 (13 marked urgent, and 21 enhancements)
  • New release of JQuery
  • Fixes an urgent cache refresh issue introduced in Foswiki 2.1.1

See ReleaseNotes02x01 for complete release notes.

For administrators:

  • CGI Sessions for guest users are no longer required for User Registration and Password reset to be functional. Disabling guest sessions can reduce the server workload.
  • The cache refresh link has been removed for guest views. Crawlers following the refresh link were invalidating the cache.
  • The Virtual machine image is updated to Ubuntu 16.04 LTS, and compressed with 7zip for faster downloads.

Translation status

As of this release,
  • French, German, Italian, Traditional Chinese and Ukrainian are 100% complete.
  • Czech, Danish are >95% complete.

For more details on translation status, see Foswiki:Community.TranslationTeam and Foswiki's Weblate translation server. Foswiki is now using continuous translation, so contributions at any time are very helpful. Foswiki thanks the Translators for their Herculean efforts. If you are interesting in helping with the translation, please contact

ALERT! Security alerts or advisories apply to this release: This release is vulnerable to the above alerts. Instructions on how to mitigate these issues are described in the alert details.


GPG Signatures and MD5 checksums are provided for verifying the integrity of the files for the primary download packages.

File GPG MD5 Description
download Foswiki-2.1.2.tgz GPG MD5 tar gz version of Foswiki
download GPG MD5 zip version of Foswiki
download Foswiki-2.1.2-vmware.7z GPG MD5 VM Image (instructions)

Upgrade packages

These packages can be used to upgrade Foswiki Release 2.0.0 or newer. See #Upgrade_Instructions for further information

ALERT! Upgrade packages must not be used to upgrade older releases.

File GPG MD5 Description
download Foswiki-upgrade-2.1.2.tgz GPG MD5 upgrade tar gz version of Foswiki
download GPG MD5 upgrade zip version of Foswiki

<blockquote class="foswikiAlert"> *This release has not been built yet!*  This is a draft of the release announcement.  If you want an early start to testing, see Development.GitBasedInstall.</blockquote>

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"Release" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"ReleaseTag" topic="%BASETOPIC%"}%"

%INCLUDE{"Download.FoswikiReleaseViewTemplate" section="download"
  release="%FORMFIELD{"Release" topic="%BASETOPIC%"}%"
  url="{"ReleaseTag" topic="%BASETOPIC%"}%"

| *File* | *GPG* | *MD5* | *Description* |
| [[%url%/Foswiki-%upgraded%%release%.tgz][%ICON{download}% Foswiki-%upgraded%%release%.tgz]] | [[%url%/Foswiki-%upgraded%%release%.tgz.asc][GPG]] | [[%url%/Foswiki-%release%.md5][MD5]] | %upgrade% tar gz version of Foswiki |
| [[%url%/][%ICON{download}%]] | [[%url%/][GPG]] | [[%url%/Foswiki-%release%.md5][MD5]] | %upgrade% zip version of Foswiki |%IF{"'%upgraded%'='' and '%FORMFIELD{"VMImage" topic="%BASETOPIC%"}%'='1'" then="
| [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%][%ICON{download}% Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%]] | [[%url%/Foswiki-%release%-vmware.%FORMFIELD{"VMFormat" topic="%BASETOPIC%"}%.asc][GPG]] | [[%url%/Foswiki-%release%-vmware.md5][MD5]] | [[Support.VirtualMachineImages][VM Image (instructions)]] |"}%%ENDSECTION{"download"}%

---++ Upgrade packages

   else="These packages can be used to upgrade __Foswiki Release %FORMFIELD{"UpgradeFrom" topic="%BASETOPIC%"}% or newer__. See [[#Upgrade_Instructions]] for further information"
   then="If you already have an earlier version of Foswiki %FORMFIELD{"ReleaseMajor" topic="%BASETOPIC%"}%.%FORMFIELD{"ReleaseMinor" topic="%BASETOPIC%"}%.X installed, you can extract an upgrade package on top of the installation. The =major.minor= part of the release should not be changed by an upgrade package."}%

%X% Upgrade packages must not be used to upgrade older releases.


Other downloads/installers

This release can also be downloaded from

Getting help & providing feedback

Don't forget to use the upgrade or installation guides. If you need help, there are several options:

We want to hear from you! Especially if you have noticed a bug, have some ideas we could use, or just want to contribute:

Known issues

The following issues have been reported against FoswikiRelease02x01x02. Tasks in "Closed" or "Waiting for Release" state will be fixed in the next release.

Major issues of Foswiki, to be fixed in: 2.1.3

The following "urgent" issues have been marked for resolution in Foswiki 2.1.3

Id Summary Component Current State
8 years
Upgrade to latest jquery-ui.
distro:a4869c27548d distro:b62305dcc608 distro:73eed2384828 distro:1768d244e512 distro:0c8259c39173 distro:3d01c2c524e9 distro:36a9ba4b29e1 distro:5001db04d277 distro:f3870c623d8d distro:a8c240509d4b distro:d704482cfc1c distro:d7a035b4d1c5 distro:d1ee12222258 distro:e2aa0480f765
JQueryPlugin Closed
7 years
ExtensionInstaller fails to replace files under some conditions.
Configure Closed
7 years
FileUtil doesn't work correctly with BSD tar.
distro:5c5d515630e2 distro:f5259881391f
Configure Closed
7 years
Any changes to a topic text made after pushing the topic to the context stack are ignored even changes are related to topic-level preferences.
distro:9e6a2679b440 distro:e42889fb1a87
FoswikiPrefs Closed
7 years
Bootstrap fails to correctly detect path when mod_rewrite engine is disabled.
ConfigureBootstrap Closed
7 years
Performance issue sorting list based on NFKD.
distro:67c475371bf6 distro:2855ba789133 distro:140e1c06bc3f
Performance, I18N Closed
7 years
Excessive calls of getPreferences(LINKTOOLTIP) causes performance issues.
distro:14838b862dae distro:85585c76df57
Performance Closed
7 years
INCLUDE{"topic,list"} fails if first topic is access denied.
6 years
Reload of a page in the cache fails to recompute strikeone keys.
distro:377070f12059 distro:c47158abfb49 distro:85621e2b8859 distro:2905c8483650
PageCache Closed
6 years
Loop in Foswiki::UI::View::revisionsAround under some conditions.
FoswikiUIView Closed
6 years
Registration confirmation process corrupts utf-8 wiki names.
distro:e245b22952d6 distro:1625ca487f6d
FoswikiUIRegister, I18N Closed
6 years
PageCache tweaks to control dependency growth.
distro:1f7cce363719 distro:fcae5c9a1c81 distro:a9c89610e0f3 distro:d95f1094bb64 distro:ba74813eca53 distro:d39fa8e270e4 distro:64a9660e8e5f distro:7c45a419dc7f distro:13d6306c25fc
PageCache, Performance Closed
6 years
Autoconfig Email failing with recent versions of IO::Socket::SSL.
distro:a5aef45c6d8e distro:a7b968afa065 distro:74d590a945a0 distro:ed6218fd5e0d distro:d079f79e1dff distro:8e8072443df4 distro:27821cd0f1c6 distro:8ff14e444ad7 distro:b8a202c056e4 distro:f174302b06d1 distro:9311e8673b5b
Configure, FoswikiNet Closed
6 years
MailerContrib mailnotify fails with wide character print when run from Web when unicode webnames are in use.
MailerContrib Closed
6 years
EditRowPlugin: edit button does not work when using Internet Explorer.
distro:de9f41895910 distro:a9cbe5b970c6
EditRowPlugin Closed
6 years
Regression: writing to STDERR is broken under FastCGI
distro:f6350568d343 distro:979a36337181 distro:bed56ea09954
FastCGIEngineContrib Closed
6 years
Documentation for the reverted META:CREATEINFO is still in the release.
Documentation, QUERY Closed
6 years
Data loss of certain formfield names when moving content from 1.x to 2.x.
distro:47238cf68eef distro:026a713017d6
DataForms Closed
6 years
Error enabling internationalization and languages
distro:aed1dc434a85 distro:dc9eb0e10ae3
Configure, I18N Closed
6 years
CLI tools/configure fails to encode Password when run in prompting mode
distro:69f877a70c63 distro:4009a9a894e8
Configure Closed
6 years
Configure extensions review crashes if plugin module uses "$RELEASE = $VERSION".
Configure Closed
6 years
Old SVN based extensions don't compare as older than new Decimal versioned extensions
Configure Closed
6 years
don't destroy dialogs on close
JQueryPlugin Closed
6 years
ASSERT in when viewing prior revisions of topics with attachments.
distro:54c394fad3a6 distro:e85d6378e992
PatternSkin, QUERY Closed
6 years
Under some conditions, Support.JEditableContrib attempts to load an .uncompressed.js source, which is not in the distribution.
JEditableContrib Closed


Please refer to the INSTALL.html which can be found the downloaded tgz/zip. It can be also found on in the System.InstallationGuide

Upgrade Instructions

In-place upgrade from any release prior to 2.0.0 is not recommended. Older Foswiki installations should install Foswiki as a new release, configure, and then migrate data to the new installation.
  • See System.UpgradeGuide for details on upgrading from older versions of Foswiki
  • See System.SystemRequirements for the latest System Requirements.
  • Be sure to take a backup!
  • The upgrade packages excludes files "commonly" modified, for example, WebHome, WebPreferences, AdminGroup, etc. If your installation has modified other topics, or template files, those updates will be lost!
  • If you use tar, then you can extract the upgrade package on top of your installation by using: (Be sure to run this as your web server user to avoid changing file ownership.)
cd /var/www/foswiki
tar --strip-components=1 -zxf /path/to/Foswiki-upgrade-2.x.x.tgz
cd tools
./configure --save
  • Similarly, if you are using the zip upgrade package, then
cd /var/www/foswiki
unzip -o /path/to/
cd tools
./configure --save

If upgrading from Foswiki 2.0.0, all working/tmp/cgisess_* files must be deleted. All users will have to log in after the upgrade. (This change was introduced in Foswiki 2.0.1.)

After upgrading from Foswiki 2.0.x, you should visit configure, enable "Expert" options, and visit the Security and Authentication > Environment tab, and "Reset" the "Name Filter" and "Upload Filter" to their default settings, in order to apply updated defaults.

The following files may be removed after upgrading from Foswiki 2.0.x to Foswiki 2.1.0:
  • pub/System/UserRegistration/js.js
  • pub/System/DefaultUserRegistration/validate.js
  • ReleaseNotes02x00.html

Upgrading from Foswiki 1.x.

Caution:There are a number of significant changes that require action before migrating data from release 1.0 and 1.1. Carefully review the release notes for ReleaseNotes02x00
  • JavaScript is now required for many operations.
  • New default PlainFileStore cannot coexist with existing RCS revision files. If new store is selected, a conversion script must be run.
  • Foswiki now defaults to utf-8, Before importing data, you must either match previous encoding, or convert the data from the old store to the new character encoding.
  • Empty DENY rules must be changed to ALLOW * wildcards. Or the old feature must be enabled in the configuration.
  • Sessions now use IP Matching by default. If your site supports roaming / mobile users or is behind a proxy, this must be disabled.
  • Installation process has changed. Do not visit bin/configure as your first URL. Go directly to your default view url and then follow the link to configure.
  • Foswiki no longer ships with CPAN perl modules. Install CPAN prerequisites using your local system package manager, cpanm, or CpanContrib
  • Perl 5.8.8 is the minimum perl release. Perl 5.20 or higher is recommended for best performance.
  • Foswiki now predominantly uses 'single quotes' in generated HTML, and "double quotes" in macros. The change to singe quotes in generated HTML may require some rework of Foswiki macros.
  • Some versions of CGI should be avoided (especially 4.10-4.13) to prevent corruption of international characters in topics when utf-8 is enabled.


  • This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
  • This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  • See the GNU General Public License for more details, published at

Release Details

Topic revision: r2 - 04 May 2016, GeorgeClark - This page was cached on 03 Jun 2023 - 16:04.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy