NOTE: This is a DistributionDocument. Please help maintain high quality documentation: This is a wiki, please fix the documentation if you find errors or incomplete content. Put questions and suggestions concerning the documentation of this topic in the comments section below. Use the Support web for problems you are having using TWiki.

TWiki System Requirements

Server and client requirements

Low client and server base requirements are core features that keep TWiki widely deployable, particularly across a range of browser platforms and versions. Many Plugins and contrib modules exist which enhance and expand TWiki's capabilities; they may have additional requirements.

Server Requirements

TWiki is written in Perl 5, uses a number of shell commands, and requires RCS (Revision Control System), a GNU Free Software package. TWiki is developed in a basic Linux/Apache environment. It also works with Microsoft Windows, and should have no problem on any other platform that meets the requirements.

Required CPAN Modules

Optional CPAN Modules

Most of them will probably already be available in your installation. You can check version numbers with the configure script, or if you're still trying to get to that point, check from the command line like this:

perl -e 'use FileHandle; print $FileHandle::VERSION."\n"'

Client Requirements

The TWiki standard installation has relatively low browser requirements:

• HTML 3.2 compliant
• Cookies, if persistent sessions are required

CSS and Javascript are used in most skins, although there is a low-fat skin (Classic skin) available that minimises these requirements. Some skins will require more recent releases of browsers. The default skin (Pattern) is tested on IE 6, Safari, and Mozilla 5.0 based browsers (such as Firefox).

You can easily select a balance of browser capability versus look and feel. Try the installed skins at TWikiSkinBrowser and more at TWiki:Plugins.SkinPackage.

Important note about TWiki Plugins

• Plugins can require just about anything - browser-specific functions, stylesheets (CSS), Java applets, cookies, specific Perl modules,... - check the individual Plugin specs.

Related Topics: AdminDocumentationCategory

Comments & Questions about this Distribution Document Topic

Would be useful to include a reference to BrowserIssues (which should really be added to the TWiki docs - let me know best way to do this). I'd also like to discuss adding WindowsInstallCookbook to the doc set.

We should also recommend Perl 5.6.1, while supporting 5.005_03.

-- RichardDonkin - 24 Mar 2002

Reference to RCS updated to reflect all Perl implementation - TWiki:Codev/RcsLite

-- JohnTalintyre - 09 Apr 2002

Added that Perl 5.6.1 is recommended, though 5.005_03 is still the target for all TWiki code (see ReadmeFirst#CodeDependencies).

-- RichardDonkin - 20 Apr 2002

Apache authentication (security) warning for clear-text "basic authentication" and SSL recommendation might be good here. Thoughts?

-- GrantBow - 05 Jan 2003

It'd be useful to have more information on using TWiki with non-Apache webservers such as Netscape Enterprise Server (although maybe that type of information should be over at TWikiOn)?

-- GarethEdwards - 09 Jan 2003

I renamed this topic from TWikiImplementationNotes to the more accurate name TWikiSystemRequirements.

-- PeterThoeny - 16 Jan 2003

Added caveats about Perl 5.8.0 and Apache 2.0, since neither of these has been very much tested with TWiki and I suspect there are problems. I know there are issues with UTF8 on Perl 5.8 and authentication on Apache 2.0 for Windows, but I would be happy to be contradicted

This does imply an update/bugfix release fairly soon after BeijingRelease - no new features but some fixes for things like this.

-- RichardDonkin - 16 Jan 2003

Updated the part about using RcsLite for grammar and clarity, added reference to TWikiOn. BTW, the new name for this topic is much easier to remember!

-- RichardDonkin - 22 Jan 2003

Added links to pages on perl 5.8 on Codev and the best Apache topic I could find (in Support). I didn't see any other appropriate pages when doing "perl" or "apache" topic name searches.

-- GrantBow - 23 Jan 2003

Updated the Perl 5.8 link to IssuesWithPerl5dot8, and did similar for Apache 2.0.

-- RichardDonkin - 10 May 2003

Update re UTF-8 URLs, and to soften the non-recommendation of Perl 5.8.

-- RichardDonkin - 26 Jul 2004

Updated the Perl version recommendation to be 5.6.2 or 5.8.5, since many people have been using 5.8.x for a year with no problems - as discussed on IssuesWithPerl5dot8, have also updated WindowsInstallCookbook.

-- RichardDonkin - 10 Dec 2004

Softened the Apache 2 discouragement and suggested 2.0.50 or higher, based on the hanging issue now resolved in that version. Latest possible version recommended anyway, and IssuesWithApache2dot0 is your friend... Users of Apache 2 on Windows who require I18N? should check status of ApacheTwoBreaksNonUTF8EncodedURLsOnWindows - currently, Apache 2.0's implementation of Unicode on Windows is causing some problems.

-- RichardDonkin - 10 Jan 2005

See RemoveNewTopicLinkStyleFromRenderDotPm where I propose to introduce minimal CSS for classic skin to show "new topic" links. This should work ok on Netscape 4.7, according to http://www.nic.fi/~tapio1/Teaching/Netscape.php3.

-- ArthurClemens - 22 Apr 2005

Re-applied Richard's Perl 5.8 link

-- TWikiGuest - 13 Oct 2005

Added patch as a requirement due to UpgradeTwiki dependency. This should go into any 4.0.x release of this doc as it caught a few people.

-- RichardDonkin - 03 Feb 2006

This topic is out of date for TWiki 4.

-- KennethLavrsen - 09 Apr 2006

Updated now to TWikiSystemRequirements content.

-- PeterThoeny - 09 Apr 2006

At the top of the page, it suggests to put changes in the comments section. As a user, I don't like this - it means I have to read pages to random comments to try and find something very simple (what version of perl is supported). It kind of defeats the point of a wiki - you might as well have a forum! However, if 'someone' plans to convert these comments into the 'official' part of this page, thats cool, but then this should be mentioned at the top of the page so that people (like me) don't get the wrong idea.

-- EricWoods - 29 Jan 2007

Ah, good point. The idea is the fix the documentation directly. The reference to the comment section is in regards to not using the comments section for support question (which happens qute often.) I fixed the top banner a bit to be more explicit. Please help fine-tune the message at DistributionDocHeader.

-- PeterThoeny - 30 Jan 2007

I updated the Required CPAN Modules table because I just built Perl 5.10 from sources and Algorithm::Diff, Error, and Text::Diff are simply not included.

-- JefferyMartin - 05 Dec 2008

The documentation on Algorithm::Diff, Error and Text::Diff was correct. They are not included in Perl, but they are included in the TWiki distribution, see twiki/lib/CPAN/lib directory.

The Encode module however is required.

I updated the docs accordingly.

-- PeterThoeny - 09 Dec 2008

Do you include the CPAN modules that you need but that are not included in the Perl base somewhere under twiki/lib/CPAN? If that is true, and the WysiwygPlugin is now part of the standard TWiki install, then you also need to include HTML::Parser.

-- JefferyMartin - 09 Dec 2008