TWiki Installation Guide
Installation instructions for the TWiki 4.0 production release.
If you are upgrading from a previous version of TWiki, you probably want to read TWikiUpgradeGuide
TWiki should be fine with any web server and OS that meet the system requirements
. The following installation instructions are written for experienced system administrators; please review the AdminSkillsAssumptions
before you install TWiki. If you need help, ask a question in the TWiki:Support
web or on TWiki:Codev.TWikiIRC
(irc.freenode.net, channel #twiki)
on TWiki.org has supplemental documentation that help you install TWiki on different platforms, environments and web hosting sites.
- Download the TWiki distribution from http://TWiki.org/download.html.
- Make a directory for the installation and unpack the distribution in it.
- Make sure the user that runs CGI scripts on your system can read and write all files in the distribution.
Detailed instructions on file permissions are beyond the scope of this guide, but in general:
- During installation and configuration, the CGI user needs to be able to read and write everything in the distribution,
- Once installation and configuration is complete, the CGI user needs write access to everything under the
pub directories and to
lib/LocalSite.cfg. Everything else should be read-only.
- Everybody else should be denied access to everything, always.
- Make sure Perl 5 and the Perl CGI library are installed on your system.
The default location of Perl is
/usr/bin/perl. If it's somewhere else, change the path to Perl in the first line of each script in the
Some systems require a special extension on perl scripts (e.g.
.pl). If necessary, rename all files in
twiki/bin (i.e. rename
view.pl etc). If you do this, make sure you set the
ScriptSuffix option in
configure (Step 6).
- Create the file
There is a template for this file in
The file must contain a setting for
$twikiLibPath, which must point to the absolute file path of your
If you need to install additional CPAN modules, but can't update the main Perl installation files on the server, you can set
$CPANBASE to point to your personal CPAN install. Don't forget that the webserver user has to be able to read those files as well.
- Configure the webserver so you can execute the
bin/configure script from your browser.
- Explicit instructions for doing this are beyond the scope of this document, though there is a lot of advice on TWiki.org covering different configurations of webserver. To help you out, there's an example Apache
httpd.conf file in
twiki_httpd_conf.txt at the root of the package. This file also contains advice on securing your installation. There's also a script called
tools/rewriteshebang.pl to help you in fixing up the shebang lines in your CGI scripts.
- Run the
configure script from your browser, and resolve any errors or warnings it tells you about.
You now have a basic, unauthenticated installation running. At this point you can just point your Web browser at
and start TWiki-ing away!
Once you have your TWiki running, you can move on to customise it for your users.
Related Topics: AdminDocumentationCategory
- The first step is to re-run the
configure script and make sure you have resolved all errors, and are happy that you understand any warnings.
- TWiki:TWiki.InstallingTWiki on TWiki.org has supplemental documentation that help you install TWiki on different platforms, environments and web hosting sites.
- If you need help, ask a question in the TWiki:Support web or on TWiki:Codev.TWikiIRC (irc.freenode.net, channel #twiki)