Installation Guide
This guide describes the steps for manually installing Foswiki, with specific steps for installations on Linux with the Apache web server.
- If you are using one of the automated installers or operating system-specific packages at Foswiki:Download.OtherFoswikiInstallers, refer to the instructions specific to those installers/packages in the first instance;
- Are you manually installing on a different web server or operating system? Would you like more information about performance tuning, security hardening or shared webhosting environments? This guide contains information relevant to most installation scenarios. For topics not covered here please consult Foswiki:Support.SupplementalDocuments
This guide is divided into two parts - included here as a single complete reference.
Installation Guide Part 1 documents the preparation steps used to make Foswiki initially operational. It is included in the root of your Foswiki distribution as a static HTML document -
INSTALL.html
Installation Guide Part 2 continues with steps for tailoring and enhancing your site.
These installation instructions are also available online at
Foswiki:System.InstallationGuide, and are available within your Foswiki installation at
System.InstallationGuide
(the InstallationGuide topic in the System web).
For information on upgrades, please also refer to
Foswiki:System.UpgradeGuide. A static HTML version of this document,
UpgradeGuide.html
, is included in the root of your Foswiki distribution.
Initial Installation
System Requirements
Please see the section "
Foswiki system requirements" for the server and client requirements to run Foswiki, including the Perl modules required on the server. If you need to install any Perl libraries from CPAN for use by Foswiki, see
Foswiki:Support.HowToInstallCpanModules for more information.
Preparing to install
Before attempting to install Foswiki, you are encouraged to review the
Foswiki:System.AdminSkillsAssumptions. This guide assumes the person installing Foswiki has a basic knowledge of server administration on the system on which Foswiki is to be installed. While it is possible to install Foswiki with FTP access alone (for example, on a hosted site), it is tricky and may require additional support from your hosting service (for example, in setting file ownership and installing missing perl CPAN libraries).
If you are upgrading from a previous Foswiki version or from a TWiki installation, please refer to
Foswiki:System.UpgradeGuide. A static HTML version of this document,
UpgradeGuide.html
, is included in the root of your Foswiki distribution.
Verify that your server meets the
Foswiki system requirements, including having the minimum required Perl version and all required Perl modules installed. If you need to install any Perl libraries from CPAN for use by Foswiki, see
Foswiki:Support.HowToInstallCpanModules for more information.
You should also take this opportunity to consider the automated installers, virtual machine images and (currently) Debian and CentOS packages at
Foswiki:Download.OtherFoswikiInstallers. These automate much of the install process and may help some users get started more easily.
Note that the installers are optimized for the target system, and typically do not follow the normal Foswiki directory structure documented below. Files are installed into system locations that are appropriate to the target OS. Review the steps below, but recognize that file locations may be different, and some installation steps such as customization of the Web Server and Foswiki,setting file ownership and permissions will have been done automatically during the package installation.
If you need help, feel free to ask a question in the
Foswiki:Support web or on
Foswiki:Community.InternetRelayChat (irc.freenode.net, channel #foswiki).
Basic installation: getting Foswiki up and running
To install Foswiki, complete the following steps:
- Download and unpack the Foswiki distribution.
- Set the file and directory permissions for the installation.
- Configure the locations of the Perl executable and the Foswiki modules.
- Configure the web server.
- Configure Foswiki.
- Enable authentication of users (if desired).
- Define the administrator users.
Download and unpack the Foswiki distribution
Download the Foswiki distribution from
http://foswiki.org/Download
Unpack the distribution file: Change to the directory where you want to place the Foswiki directory. Unzip or untar and gunzip the distribution; a new subdirectory called Foswiki-VERSION will be created. You can rename this subdirectory to a shorter name. For the rest of this document, this subdirectory is assumed to be at
/path/to/foswiki
.
- Note: Foswiki does not support directory paths that contain spaces, so ensure that all of its directory paths do not contain any spaces (particularly on Windows).
If you do not have shell access to your web server host, see the section "
Uploading the Foswiki distribution to your web server host".
(Not applicable on Windows) Set the file and directory permissions for the installation
Set up access file and directory rights, as well as file ownership, as required by your web server configuration so that the web server user (the user used by the web server to run CGI programs) can read and write within the
foswiki
directory tree.
Note: for more information on the appropriate permissions to ensure security for your Foswiki data, see
Foswiki:Support.SecuringYourSite.
The default file and directory access permissions as set by the distribution define a reasonable security level that will work for many types of installations, including shared hosting. Nonetheless, you should verify that the web server user has read access to all files and directories beneath the
foswiki
directory, and execute access for all directories. Also verify that the
data
and
pub
directories and all the subdirectories and files beneath them allow write access for the web server user.
- Warning: Do not just run a
chmod -R 770 foswiki
. Providing execute access to all files is potentially dangerous. This is a common mistake made by Foswiki installers. See Foswiki:Support.SettingFileAccessRightsLinuxUnix for a sample set of Unix commands to set the file and directory permissions.
It is possible to define tighter access permissions than the default ones; how tight they should be depends on your web server environment and local needs. Typically you should limit all access from others if the web server machine has login access for users other than root and the web server administrator. For a dedicated web server that just runs Foswiki and has limited login access, the default access permissions have a good safety level.
If you have root user permissions, then for additional security, you can change the ownership of the
foswiki
directory tree to the web server user, using the command
chown -R user:group /path/to/foswiki
. The web server username varies in different installations; here are some sample commands for various Linux distributions:
- RedHat, Fedora, CentOS, Gentoo, Mandriva :
chown -R apache:apache /path/to/foswiki
- debian/Ubuntu/Kubuntu :
chown -R www-data:www-data /path/to/foswiki
- Suse :
chown -R wwwrun:www /path/to/foswiki
If Foswiki stops working after you applied a change in access permissions and you wish to restore the original permissions, run the Unix commands located at
Foswiki:Support.SettingFileAccessRightsLinuxUnix.
(optional - required on Windows ) Configure the locations of the Perl executable and the Foswiki modules
If you are running on a Linux system with Perl found in
/usr/bin/perl
then this step is not required. This step is
required on Windows installations.
The easiest way to fix up the bin scripts is to run the
tools/rewriteshebang.pl
script. If the Perl interpreter is in the default execution path, follow these steps:
cd /path/to/foswiki/tools
perl -I ../lib rewriteshebang.pl
or for Windows users:
cd C:\path\to\foswiki\tools
perl -I ..\lib rewriteshebang.pl
The script will determine the location of the Perl interpreter and will prompt to update both the bin and tools scripts in a single step. The changed files will be reported, and it is safe to rerun the script.
If the
perl
command does not work from the command line, then you need to find the location of your system's Perl interpreter. Insert the path to Perl in the first line of the
rewriteshebang
script. For example:
cd C:\path\to\foswiki\tools
C:\path\to\perl -I ..\lib rewriteshebang.pl
(optional) Configuration of a script suffix for the perl scripts
Some web servers require a special extension on perl script files (e.g.
.cgi
or
.pl
). This is not normally required with the Apache web server, though some hosted web servers are configured to require it. If the documentation for your web server indicates that a special extension is necessary, rename all the executable scripts in
bin
; that is, rename
bin/view
to
bin/view.pl
, and so on. When configuring Foswiki (see the section "
Configure Foswiki"), set the
ScriptSuffix
option to the special extension.
(optional) Configuration for non-standard library locations
A standard Foswiki install has the directories
bin/
and
lib/
located under the Foswiki installation directory. If you have moved these directories, or if your system requires changes to the default Perl libraries, then this step is required.
Create the file LocalLib.cfg located at
bin/LocalLib.cfg
- In the
bin
directory, copy the template file LocalLib.cfg.txt
to LocalLib.cfg
. Make sure the ownership and access rights of the copy are the same as LocalLib.cfg.txt.
- Edit
bin/LocalLib.cfg
so that $foswikiLibPath
is set to the absolute file path of your lib
directory. For example: /path/to/foswiki/lib
.
- 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 web server user has to be able to read those files as well.
Configure the web server
First choose the best configuration method for your web server. With Apache, there are two ways to configure it: a config file included from httpd.conf or .htaccess files.
- Apache config file: The recommended method is using a config file. With a config file you can put the entire Foswiki configuration in ONE file (typically named
foswiki.conf
). Performance is much better with a config file, and one file gives the best overview and ensures that you get a safe installation . However to use a config file you need root or sudo access to stop and start Apache. The Foswiki apache config file can be included from the main Apache config file. (Typically httpd.conf
or apache.conf
depending on your distribution). However most distributions have a directory from which any file that ends with .conf
gets included when you restart Apache (Example RedHat/Fedora/Centos: /etc/httpd/conf.d
, Gentoo: /etc/apache2/vhost.d
). If you use a virtual host setup in Apache you should include the foswiki.conf
file from inside the desired virtual host config in your Apache configuration.
- .htaccess files: This method should only be used when you cannot use a config file. Performance is slower as Apache must search through all applicable directories for any
.htaccess
files on each page access. Normally this is the only way to control Apache in a shared host environment where you have no root or sudo privileges.
If you are using a config file:
- The easiest and best way is to use the Foswiki:Support.ApacheConfigGenerator tool to generate a safe, working config file for your Foswiki installation, based on the options you choose in the tool.
- If you can't use the online configuration generator, a sample config file called
foswiki_httpd_conf.txt
can be found in the root of the foswiki installation.
- Ensure that web access is denied to all Foswiki subdirectories other than
bin
and pub
.
- Ensure there is either a
ScriptAlias
directive for the bin
subdirectory, or an Alias
directive with SetHandler cgi-script
and Options ExecCGI
directives for the bin
subdirectory, so that the bin
scripts will be executed by Apache.
- Note: you must restart Apache after making changes to your config files for the changes to take effect.
If you are using a .htaccess file:
- In the root of the foswiki installation, there are sample
.htaccess
files for various subdirectories in your installation. Each file has help text explaining how to modify it for your configuration. For more information, see Foswiki:Support.SupplementalDocuments. location and name of sample .htaccess file | copy sample file to the following location |
foswiki/root-htaccess.txt | foswiki/.htaccess |
foswiki/bin-htaccess.txt | foswiki/bin/.htaccess |
foswiki/pub-htaccess.txt | foswiki/pub/.htaccess |
foswiki/subdir-htaccess.txt | foswiki/<subdir>/.htaccess Copy to all other subdirectories below foswiki , including data , lib , locale , templates , tools , working . Copy to any other directories except for bin and pub addressed above. |
- Ensure that web access is denied to all Foswiki subdirectories other than
bin
and pub
. The sample .htaccess
files show how to configure Apache appropriately. It is important to verify that none of these directories can be directly accessed.
- Ensure that the
foswiki/bin/.htaccess
files contains the line SetHandler cgi-script
so that all scripts in the bin
directory will be executed by Apache.
- Note: On Linux systems, files named with the leading "." like
.htaccess
are hidden files and will not be listed unless using the -a option, ex. ls -la
Turn off any kind of PHP, Perl, Python, Server Side Includes, or other software execution mechanisms supported by your web server in the pub
directory. For example, most Linux distributions have a default Apache installation with PHP and server side include (SSI) enabled. This would allow PHP scripts uploaded as attachments to be executed, which is a security risk, so it should be disabled in the Apache configuration with
php_admin_flag engine off
.
Different script execution mechanisms are disabled in different ways; see your web server configuration and documentation for more details.
Protect the configure script!
You should never leave the configure
script open to the public. Limit access to the
bin/configure
script to either localhost, an IP address or a specific user using basic Apache authentication. The
Foswiki:Support.ApacheConfigGenerator lets you setup who has access to the
configure
script. Also see the
foswiki-httpd-conf.txt
or
bin/.htaccess.txt
file for an example of the setting required to protect the
configure
script.
To limit access to a particular user, set up a
.htpasswd
file that contains the user name and password that Apache will use to authenticate the user:
- Caution! Do not follow these steps on an existing Foswiki
.htpasswd
file. It will destroy the email addresses stored in that file! If the file already exists, you can choose an existing user for access to configure.
- Change to the
foswiki/data
directory.
- Issue the command
htpasswd -c .htpasswd <username>
, where <username> is the name of the user you will use to access the configure
script. Choose the username with care: the username cannot be an existing login name for your Foswiki installation, nor can it be used later on to register in Foswiki. Enter a password when prompted.
All of the above methods - Sample configuration files,
Foswiki:Support.ApacheConfigGenerator and sample
.htaccess
files, all include example settings to protect the configure script with a password. The critical section looks something like:
<FilesMatch "configure.*">
SetHandler cgi-script
Order Deny,Allow
Deny from all
# List of IP addresses allowed to access configure
Allow from 127.0.0.1 192.168.1.10
# specify username used on the "htpasswd" command above
Require user someuserid
# Set to "Any" to allow IP -or- userid, set to "All" to require both match
Satisfy Any
ErrorDocument 401 default
</FilesMatch>
Note: In addition to any web server security protection that you have set up, when saving any configuration settings for the first time on the
configure
web page, you will be prompted to set a configuration password. This password must be entered on all subsequent configuration changes, and is also used to log in via the internal admin link (see the section "
Define the administrator user(s)"). Even after a
configure
password has been set, access to the
configure
page should still be restricted by the web server, in order to avoid revealing internal information to potential attackers.
Tip: You do not have to use the same password file for both Configure and for Foswiki user registration. If you use a separate file, you can create it using the htpasswd
commmand and complete segregate configure access from Foswiki access. This is probably safer, but does not allow users to change their configure password using Foswiki services. The password file has to be manually maintained..
- Generate an alternate password file to protect configure.
htpasswd -c -s /path/to/data/.htpasswd-admin configuserid
- Add / modify and delete this alternate file using the
htpasswd
command. Don't mix them up and use htpasswd
on the Foswiki .htpasswd file!
- Edit the foswiki apache configuration and modify the block (shown above) that protects the configuration command. Add or modify the following statements in the block. Don't remove the other statements!
<FilesMatch "configure.*">
AuthType Basic
AuthName "admins only"
AuthUserFile /path/to/data/.htpasswd-admin
# Changing the Require user to Require valid-user allows any ID in the
# file access to configure!
Require valid-user
</FilesMatch>
For more information, refer to
Foswiki:Support.ProtectingYourConfiguration.
Configure Foswiki
Run the configure script from your browser: enter
http://yourdomain/url/to/foswiki/bin/configure
into your browser address bar.
- When you access the
configure
web page for the first time, you can only edit the section General Path Settings
. Make any required changes, and save the settings, whether or not you needed to make any changes. You will be prompted to set a password for the configure
page: this password must be entered for all subsequent configuration changes, and is also used to log in via the internal admin link (see the section "Define the administrator user(s)"). Note: The configure
password is remembered by configure
, separate to web server access controls mentioned in "Protect the configure script".
- After saving the
General Path Settings
, continue configuring Foswiki. Configuration items which may require further attention will be highlighted.
- If the Foswiki installation can be accessed by more than one protocol://domain, ensure the additional alternative URLs are set in
{PermittedRedirectHostUrls}
. Example: if {DefaultUrlHost}
is set to https://wiki.company.com
, an example {PermittedRedirectHostUrls}
might contain: https://company.com, http://111.222.123.234
- Setup the
Mail and Proxies
section. Email must be available so Foswiki can send registration emails.
- Under the "Email General" tab, If you do not want to enable sending registration emails or want to enable it later you can uncheck
{EnableEmail}
. Otherwise the {WebMasterEmail}
parameter must be configured.
- Under the "Email Server" tab, you can choose 3 methods of sending email. This is explained in detail under the help text for this tab.
-
MailProgram
is typically suitable on most Linux systems, and no further configuration is required.
- If you chose either of the
Net::SMPT
methods, you must also configure {SMTP}{MAILHOST}
. Many ISPs have introduced authentication when sending emails to fight spam so you may also have to set {SMTP}{Username}
and {SMTP}{Password}
.
-
Net::SMTP::SSL
will encrypt the connection to the e-mail server and is required for some email services like Google's GMail.
- Under the "Proxy" tab, if your server is behind a firewall with a proxy, and you wish to install extensions via
configure
, you may have to set {PROXY}{HOST}
and {PROXY}{PORT}
. Note: A standard Foswiki installation will not allow any new registrations unless there is a working SMTP configuration
SMTP authentication requires additional perl modules including Authen::SASL
and MIME::Base64
,
If there is a problem with your setup that prevents you from accessing the
configure
page, you can
configure Foswiki manually.
Authentication
Authentication of users means their activity can be tracked, and access to your site can be controlled.
This is particularly important for sites that are publicly accessible on the web. You are strongly encouraged to read
System.UserAuthentication and
Foswiki:Support.UserAuthenticationSupplement for further information about managing users and access controls for your Foswiki site.
The most common authentication methods used for public Foswiki installations are Template Login and Apache Login. They have the following relative advantages:
- Template Login can be set up without any web server configuration, and users can log off without restarting the browser. As the login page is just a Wiki page, you can customize it to suit your needs.
- Apache Login allows you to use any Apache-module based authentication scheme, such as
mod_auth_ldap
or mod_auth_mysql
. However, as your browser is caching your login, you must restart the browser to log out.
Note that the password databases for both of these authentication mechanisms are compatible, so you can switch between them at a later date.
To make it easier to follow the instructions in this section, you can view this installation guide using your Foswiki site by entering
System.InstallationGuide
into the "Jump" text box. By doing this instead of using the
INSTALL.html
file from the distribution, you will be able to use the embedded hyperlinks to jump directly to the referenced pages.
Template Login authentication
Template Login asks for a username and password in a web page, and processes them using whatever Password Manager you choose. Users can log in and log out. Client Sessions are used to remember users. Users can choose to have their session remembered so they will automatically be logged in the next time they start their browser.
Enabling Template Login
By default, your Foswiki installation is probably already using TemplateLogin, HtPasswdUser and TopicUserMappingContrib as the default Login
, Password
and user mapping
options.
- Using configure:
- Navigate to the
Login
tab on the Security and Authentication
panel. Select the Foswiki::LoginManager::TemplateLogin
login manager.
- Navigate to the
Passwords
tab. Select the appropriate PasswordManager
for your system - the default is Foswiki::Users::HtPasswdUser
. There is also an EXPERT configure setting {TemplateLogin}{PreventBrowserRememberingPassword}
that you can set to prevent Browsers from remembering username and passwords if you are concerned about public terminal usage.
- Verify that registration works by registering yourself with the System.UserRegistration topic. If there are problems, try these troubleshooting tips:
- If you are reading this from the INSTALL.html file, you can enter System.UserRegistration into the 'Jump' box in the top right of any Foswiki page.
- Note: A standard Foswiki installation will not allow any new registrations unless there is a working SMTP configuration
- If your PasswordManager is
HtPasswdUser
(the default), check the .htpasswd
file is being updated correctly with a new entry. If not, check {Htpasswd}{FileName}
is correct (under Security and Authentication
on the Password
tab in configure
), and that the webserver user has write permission.
- Create a new topic (in Sandbox web for example) to confirm that authentication works.
- Add users to the User.AdminGroup. Edit the User.AdminGroup topic in the User web to include users that should have administrator status. Read defining adminstrator user(s) for more information.
This is a very important step, as users in this group can access all topics, independent of Foswiki access controls.
AccessControl has more information on setting up access controls.
Foswiki AccessControls do not protect topic attachments unless the web server has been configured to do so using the viewfile
script. Visit Foswiki:Support.ApacheConfigGenerator for examples using Apache.
As Template Login uses a wiki page for its login prompt, there is a great deal of flexibility in customizing the login page for your purposes.
The default new user template page is in System.NewUserTemplate. The same macros get expanded as in the template topics. You can create a custom new user topic by creating the NewUserTemplate topic in User web, which will then override the default in System web. See System.UserForm for copy instructions.
Custom registration page
You can customize the default
System.UserRegistration topic by first copying
System.DefaultUserRegistration to UserRegistration in User web. This will ensure that your changes will remain intact next time you upgrade.
A couple of common fields are hidden from normal view to make the registration page as lean as possible. You can unhide those fields on the page by removing
EXCLUDED_
from the
INCLUDE
tags) or add new ones.
New fields may also be added. The
name=""
parameter of the
<input>
tags must start with:
"Fwk0..."
(if this is an optional entry), or
"Fwk1..."
(if this is a required entry). This ensures that the fields are carried over into the user home page correctly.
Automatic Group Membership
The TopicUserMappingContrib can also enroll users into groups during registration. (Other mappers might not support this feature). Options include:
- Automatically enrolling users in one or more groups during registration
- Allow the user to select multiple groups from a list of eligible groups
- Allow the user to choose only one group from a list of eligible groups
- Don't do any group enrollment during registration.
The list of eligible groups can be generated in one of two ways:
- Manually by configuration. This fixed list of groups will always be listed.
- Automatically based upon CHANGE permission on the group topics.
There are two registration scenarios that apply:
-
Self-registration by Guest users
- The actual registration will be processed by the special internal user User.RegistrationAgent. Group topics must include an ALLOWTOPICCHANGE = User.RegistrationAgent to be eligible for enrollment.
-
Registration by logged-in users
- The registration form is filled out by some other logged-in user. In this case, the User.RegistrationAgent is not used for Group updates. The current user must have ALLOWTOPICCHANGE permission for groups for them to be eligible for enrollment.
- Caution: If an administrator registers a user with automatic group membership enabled, the new user could potentially be added to All groups. Use caution with this feature!
Note: During registration, if it turns out that the current user or User.RegistrationAgent doesn't have permission to update the group topic, the group update will be silently skipped. The user will still be albe to register.
See DefaultPreferences#RegistrationOptions for further details. Copy the settings into User.SitePreferences to make them active.
Apache Login authentication
With Apache Login enabled, when Foswiki needs to authenticate the user, the standard HTTP authentication mechanism is used: the browser itself will prompt for a user name and password.
The advantage of this scheme is that if you have an existing website authentication scheme using Apache modules such as
mod_auth_ldap
or
mod_auth_mysql
you can just plug in to them directly.
The disadvantage is that because the user identity is cached in the browser, you can log in, but you can't log out again unless you restart the browser.
Foswiki maps the
REMOTE_USER
that was used to log in to the webserver to a WikiName using the table in User.WikiUsers. This table is updated whenever a user registers, so users can choose not to register (in which case their webserver login name is used for their signature) or register (in which case that login name is mapped to their WikiName).
The same private
.htpasswd
file used in Foswiki Template Login can be used to authenticate Apache users, using the Apache Basic Authentication support.
Do not use the Apache htpasswd
program with .htpasswd
files generated by Foswiki! htpasswd
wipes out email addresses that Foswiki plants in the info fields of this file.
Apache Login is required for Apache-based login methods such as mod_ldap
You can use any Apache authentication module that sets the REMOTE_USER
environment variable.
To setup Apache Login, perform the following steps:
- Configure Apache Login. Under the
Security and Authentication
pane on the Login
tab in configure
:
- Select
Foswiki::LoginManager::ApacheLogin
for {LoginManager}
.
- Select
Foswiki::Users::HtPasswdUser
for {PasswordManager}
.
- Select
Foswiki::Users::TopicUserMapping
for {UserMappingManager}
.
- Save your settings.
- Configure your Apache settings for HTTP authentication. Use the Foswiki:Support.ApacheConfigGenerator tool or the
foswiki/bin-htaccess.txt
file to set the following Apache directives on the bin
scripts:
<FilesMatch "(attach|edit|manage|rename|save|upload|mail|logon|rest|.*auth).*">
require valid-user
</FilesMatch>
You can also refer to the sample foswiki_httpd_conf.txt
and bin-htaccess.txt
files to see how the appropriate Apache directives are specified.
- Verify that registration works by registering yourself with the System.UserRegistration topic. If there are problems, try these troubleshooting tips:
- If you are reading this from the INSTALL.html file, you can enter System.UserRegistration into the 'Jump' box in the top right of any Foswiki page.
- Note: A standard Foswiki installation will not allow any new registrations unless there is a working SMTP configuration
- If your PasswordManager is
HtPasswdUser
(the default), check the .htpasswd
file is being updated correctly with a new entry. If not, check {Htpasswd}{FileName}
is correct (under Security and Authentication
on the Password
tab in configure
), and that the webserver user has write permission.
- Create a new topic (in Sandbox web for example) to confirm that authentication works.
- Add users to the User.AdminGroup. Edit the User.AdminGroup topic in the User web to include users that should have administrator status. Read defining adminstrator user(s) for more information.
This is a very important step, as users in this group can access all topics, independent of Foswiki access controls.
Choose an appropriate search algorithm for your Operating System
On the
Store
pane in
configure
you will find the setting
{RCS}{SearchAlgorithm}
.
By default it is set to
Foswiki::Store::SearchAlgorithms::Forking
which is what you should keep if you install Foswiki in Linux or any other Unix type operating system.
If you install Foswiki on a Windows server, using an external grep program can create problems because of limitations in the length of command lines. You may be able to run with Forking in Windows if your directory path to Foswiki is kept short (short directory names and few levels), however the recommended (safe) setting for Windows is
Foswiki::Store::SearchAlgorithms::PurePerl
.
Define the administrator user(s)
About Administrators
Administrators have read and write access to any topic, regardless of any access controls that have been applied to the topic or its web. The
special user User.AdminUser ships with Foswiki and is accessed using by logging in with user
admin
and the password established when initially saving the configuration.
Don't log in with the wikiname AdminUser
.
After installing Foswiki, you can also register other users that you will use to administer Foswiki. To make a user an administrator, add the WikiName for the user to the
AdminGroup
, defined in the
User.AdminGroup
topic in your Foswiki installation.
Note that with the
sudo or internal admin login, it is not necessary to add other users to the AdminGroup. However if you have more than one administrator, you may still want to do this to ensure that topic changes are attributed to a specific user instead of the default User.AdminUser.
By adding users to User.AdminGroup:
- Users with Admin rights will have routine access to topics that might normally be denied.
- These users will be unable to test or demonstrate access controls.
- Changes made are always attributed to a unique logged in user.
- Password sharing of the
bin/configure
password is not required
By using the
internal admin login:
- You don't need to grant admin rights to individual users
- All users will be subject to access controls.
- Changes made while using the internal admin login are attributed to User.AdminUser
- The "save" password for
bin/configure
will need to be shared among administrators
Adding users to the User.AdminGroup
To make it easier to follow the instructions in this section, you can view this installation guide using your Foswiki site by entering
System.InstallationGuide
into the "Jump" text box. By doing this instead of using the
INSTALL.html
file from the distribution, you will be able to use the embedded hyperlinks to jump directly to the referenced pages.
To add an initial administrator to the
AdminGroup
, perform the following steps:
- If you are not already logged in with your WikiName, then login.
- Go to the
User.AdminGroup
topic and select the "internal admin login" link. Login using the password you set on the configure
page.
- After logging as the internal admin, view the
User.AdminGroup
topic. Follow the instructions on the page to add users to the AdminGroup. You do not need to edit the topic.
Any member of the User.AdminGroup can add subsequent members — you do not have to use the internal admin login.
To more easily debug access control issues, you may want to have a regular Foswiki user account for daily use, and a special one that belongs to the
AdminGroup
that you use only for administering your Foswiki site. See
System.AccessControls for more information on access controls and user groups.
Congratulations!
You now have a basic installation running. At this point you can just point your Web browser at
http://yourdomain.com/url/to/foswiki/bin/view/System/InstallationGuidePart2
to proceed with further tailoring your site..
In order to keep your user, group, and site configuration information separate from the actual content of your site, it is recommended that you create a new web in which your site's pages will reside. See
System.ManagingWebs for more information on Wiki webs and how to create one.
Troubleshooting
Foswiki system requirements
Low client and server base requirements are core features that keep Foswiki widely deployable, particularly across a range of browser platforms and versions. Many extensions exist which enhance and expand Foswiki's capabilities; they may have additional requirements.
Server Requirements
Foswiki is written in Perl 5, which is supported on Microsoft Windows as well as Unix and Unix-like systems (including Linux and OSX), on which it uses a number of shell commands and
RCS (Revision Control System), a GNU Free Software package. It should be able to run on any server platform that meets the following requirements.
Resource |
Required Server Environment |
Perl |
5.8.8 or higher |
RCS (Revision Control System) |
5.7 or higher (including GNU diff ) Optional. Foswiki includes a pure Perl implementation of RCS (RcsLite) that can be used instead, at the cost of performance |
GNU diff |
GNU diff 2.7 or higher is required when not using the all-Perl RcsLite. Install within the PATH if not included with RCS (check version with diff -v ) Must be the version used by RCS, to avoid problems with binary attachments - RCS may have hard-coded path to diff |
Other external programs |
fgrep, egrep |
Cron/scheduler |
• Unix: cron • Windows: cron equivalents |
Web server |
Apache is well supported; for information on other servers, see Foswiki:Support.InstallingOnSpecificPlatforms. |
Perl Modules
A complete list of the required and optional Perl modules can be found in
lib/DEPENDENCIES
.
The following CPAN modules are not shipped with Foswiki. Note that Foswiki extensions may add additional requirements.
Modules marked as Required may still be optional if certain default core features are not used.
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"'
For more detailed dependency information, try the script
dependencies_installer.pl
located in the
tools
directory, which makes perl module installation easier. Run it with option
-h
to understand basics. This script requires confirmation before it actually does something.
Specific distribution details
Ubuntu and other Debian derived distributions
Install apache and rcs
apt-get install apache2 rcs
Perl Module |
Package to install |
Notes |
HTML::Parser |
libhtml-parser-perl |
|
HTML::Entities |
|
included with HTML::Parser |
HTML::Tree |
libhtml-tree-perl |
|
LWP |
libwww-perl |
|
version |
libversion-perl |
Must be version 0.77 or newer |
Digest::SHA |
libdigest-sha-perl |
|
Digest::SHA1 |
libdigest-sha1-perl |
|
URI |
liburi-perl |
|
Net::SMTP::SSL |
libnet-smtp-ssl |
|
Authen::SASL |
libauthen-sasl |
note, broken on Ubuntu 11.10 x64. Install using CPAN! |
After expanding the Foswiki archive, change the ownership of the files:
- Debian, Ubuntu, Kubunto:
chown -R www-data:www-data /path/to/foswiki
RedHat, SuSE, CentOS and other RPM based distributions
Install apache2, rcs, and perl-CPAN
Perl Module |
Package to install |
Notes |
HTML::Parser |
perl-HTML-Parser |
|
HTML::Entities |
|
included with HTML::Parser |
HTML::Tree |
perl-HTML-Tree |
|
LWP |
perl-libwww-perl |
|
version |
|
Must be version 0.77 or newer |
Digest::SHA |
perl-Digest-SHA |
|
Digest::SHA1 |
perl-Digest-SHA1 |
|
URI |
perl-URI |
|
Net::SMTP::SSL |
perl-Net-SMPT-SSL |
|
Authen::SASL |
perl-Authen-SASL |
|
After expanding the Foswiki archive, change the ownership of the files:
- RedHat, Fedora, CentOS Mandriva: chown -R apache:apache /path/to/foswiki=
- Suse:
chown -R wwwrun:www /path/to/foswiki
Client Requirements
The
standard installation has relatively low browser requirements:
- XHTML 1.0 Transitional compliant
- Cookies, if persistent sessions are required
- Javascript, for edit/save/upload functionality
Change {ValidationMethod}{Method}
from strikeone
to embedded
in configure to allow non-javascript browsers to edit/save/upload
CSS and Javascript are used in most skins. Some skins will require more recent releases of browsers. The default skin is tested on IE 6+, Safari, Chrome and Firefox.
You can easily select a balance of browser capability versus look and feel. Try the installed skins at System.SkinBrowser and more at
Foswiki:Extensions.SkinPackage.
Uploading the Foswiki distribution to your web server host
If you cannot unpack the Foswiki distribution directly in your installation directory, you can unpack the distribution on your local computer, manually create the directory structure on your host server and upload the files as follows:
- Using the table below, create a directory structure on your host server
- Upload the Foswiki files by FTP (transfer as text except for the image files in
pub
directory.)
- Note: Don't worry if you are not able to put the
lib
directory at the same level as the bin
directory. You can create this directory elsewhere and configure the bin/setlib.cfg
file. Foswiki dir: | What it is: | Where to copy: | Example: |
foswiki | start-up pages | root Foswiki dir | /home/smith/public_html/foswiki/ |
foswiki/bin | CGI bin | CGI-enabled dir | /home/smith/public_html/foswiki/bin |
foswiki/lib | library files | same level as bin | /home/smith/public_html/foswiki/lib |
foswiki/locale | language files | dir secure from public access | /home/smith/public_html/foswiki/locale |
foswiki/pub | public files | htdoc enabled dir | /home/smith/public_html/foswiki/pub |
foswiki/data | topic data | dir secure from public access | /home/smith/public_html/foswiki/data |
foswiki/templates | web templates | dir secure from public access | /home/smith/public_html/foswiki/templates |
foswiki/tools | Foswiki utlilities | dir secure from public access | /home/smith/public_html/foswiki/tools |
foswiki/working | Temporary and internal files | dir secure from public access | /home/smith/public_html/foswiki/working |
Configuring Foswiki manually (without using the configure
page)
It is highly recommended that you configure Foswiki by using your browser to access the
configure
page. However, if you are unable to get the
configure
page to display (for example, if a dependency is missing), or for some reason you do not wish to use the
configure
page, then you can configure Foswiki manually
Perform the following steps to manually configure Foswiki:
- Remove the line containing
__END__
and everything following it.
Beyond the basic installation
Once you have Foswiki installed and running, you can perform one or more of the following steps to tailor your installation to your needs. Many of the references in this section refer to topics within your Foswiki installation. For example,
System.Skins
refers to the
Skins
topic in your System web. To go directly to a topic, enter the full topic name, such as
System.Skins
, into the "Jump" text box at the top right of any Foswiki page.
To make it easier to follow the instructions in this section, you can view this installation guide using your Foswiki site by entering
System.InstallationGuide
into the "Jump" text box. By doing this instead of using the
INSTALL.html
file from the distribution, you will be able to use the embedded hyperlinks to jump directly to the referenced pages.
All of the Foswiki documentation can also be found online in the
Foswiki documentation section (the "System" web) of the Foswiki web site.
Note the
configure
page mentioned in this section is accessed by visiting
https://nats-www.informatik.uni-hamburg.de/bin/configure
your web browser.
Site configuration and maintenance
Set Foswiki Preferences
Preferences for customizing many aspects of Foswiki are set by editing
User.SitePreferences
. If a given preference is not set in
User.SitePreferences
, then a default value is picked up from
System.DefaultPreferences
, if present, or, for extensions, from the extension topics.
To simplify your upgrades, do not modify
System.DefaultPreferences
. Instead, copy any settings you want to change from
System.DefaultPreferences
to
User.SitePreferences
.
To see the available preferences that can be set, look through
System.DefaultPreferences
.
If, for some reason, you wish to pick up default preferences from a different topic, you can set the location in the
Miscellaneous settings
pane of the
configure
page, in the
{SitePrefsTopicName}
setting (visible when Expert mode is enabled). It is recommended that you leave this setting to its default value,
DefaultPreferences
.
Select the desired security level
Foswiki has a many security features that can be enabled/disabled and adjusted to suit your needs.
In many cases enabling a security feature prevents other features. It is a balance that the administrator has to choose depending on the purpose of the Foswiki installation (confidential vs public knowledge), the type of installation (intranet vs internet), and your type of business.
A new administrator is encouraged to read
Foswiki:Support.SecurityFeatures which gives a walkthrough of the different security aspects and how to set the appropriate configuration settings. Note that that some security settings are only visible in configure in "expert mode" which you enter by clicking the "Yes, I've read all the documentation" button at the top of the configure screen.
Enable Email Notification
Each web has an automatic email notification service that sends you an email with links to all of the topics modified since the last alert. To enable this service:
- Confirm the Mail and Proxies settings on the
configure
page.
- Setup a cron job (or equivalent) to call the
tools/mailnotify
script, as described in the System.MailerContrib topic.
Enable Signed Email Notification
Foswiki administrative emails are an attractive target for SPAM generators and phishing attacks. One good way to protect against this possibility to enable S/MIME signatures on all administrative e-mails. To do this, you need an an X.509 certificate and private key for the the
{WebMasterEmail}
email account. Obtain these as you would for any other S/MIME e-mail user.
To enable Foswiki to sign administrative e-mails:
- Enable e-mail as described above
- Ensure that the system has the CPAN module
Crypt::SMIME
installed.
- If necessary, convert your certificate and key files to PEM format ( openssl has all the necessary utilities)
- Place the certificate anyplace convenient that the webserver can read. It should be protected against write. The conventional place under linux is
/etc/pki/tls/certs
- Place the key file in a secure location that only the webserver (or CGI user) can read. It must not be readable by anyone else, and must not be served by the webserver.
- Using the
configure
script, change the following settings under Mail and Proxies:
- "Email Server" tab. Follow the directions under
{MailMethod}
and {MailProgram}
to enable an external mail program such as sendmail. Net::SMTP
is not supported.
-
{SMTP}{MAILHOST}
, {SMTP}{SENDERHOST}
, {SMTP}{Username}
and {SMTP}{Password}
are not used an may be deleted.
- If Foswiki variable
SMTPMAILHOST
is defined in User.SitePreferences
it should be removed.
- "S/MIME" tab:
- Enable the S/MIME checkbox
- Enter the full path to the certificate file in the
{SmimeCertificateFile}
configuration variable
- Enter the full path to the private key file in the
{SmimeKeyFile}
configuration variable
- Save the configuration
- Re-run the
configure
script an resolve any errors that it identifies
All out-going administrative e-mails will now be signed.
Automate removal of expired sessions and lease files
By default Foswiki cleans out expired session and lease files each time any topic is viewed, but this has a performance cost. Instead you may wish to schedule a cron job (or equivalent) to run the
tools/tick_foswiki.pl
script, and set a negative value on the
configure
page for
{Sessions}{ExpireAfter}
. For more details, read
System.CommandAndCGIScripts#tick_foswiki_pl.
Enable WebStatistics
You can manually or automatically generate a listing of the most popular pages for each web, based on number of visits. For information on setting up this feature, see the
System.SiteTools#WebStatistics topic.
Enable Localisation
Foswiki supports displaying national (non-ASCII) characters, and using different languages for its basic interface elements. To configure localisation, modify the
Localisation
section of the
configure
page. For more information, see
Foswiki:Support.InternationalizationSupplement.
Customizing your site
Customize pages for managing personal information
If you are not using Foswiki to manage your users' passwords or email addresses, or would just like to enhance the default pages, then modify the following topics accordingly with information appropriate for your site:
Customize the user topic for new users
When a new user registers on your Foswiki site, a topic with a name corresponding to the user's WikiName is created in the User web: this topic is the user's user topic. The user topic is based on the
User.NewUserTemplate topic; if it is not present, then
System.NewUserTemplate (and its associated
System.UserForm) is used as a default. If you want to customize the user topic for your users, copy
System.NewUserTemplate to
User.NewUserTemplate, and
System.UserForm to
User.UserForm, and make your changes to
User.NewUserTemplate and
User.UserForm. (See System.ManagingTopics#CopyTopic for instructions on copying a topic.)
You can edit these topics to suit your needs, such as the following:
- Customize the user topic for your site.
- Add an
ALLOWTOPICCHANGE
preference setting to User.NewUserTemplate so only the user can edit their own user topic. In particular, on a public Foswiki site, restricting edit access will avoid vandalism and spam.
- Add and remove fields defined in the User.UserForm.
If you added or removed fields from the user form you may also need to tailor
User.UserRegistration to match (copy over the contents from
System.UserRegistration to
User.UserRegistration when creating it).
Customize the appearance of your Foswiki site
The real power of Foswiki lies in its flexibility to be customized to meet your needs. To change the look of the default skin, PatternSkin, please refer to
System.PatternSkin and
System.PatternSkinCustomization.
At the
Foswiki website you can find more resources. A good place to start exploring is
Foswiki:Support.BestPracticeTips and
Foswiki:Support.FAQ which offer tips and tricks for customizing your Foswiki site. Many of these are best done before any content has been added to your site, so immediately after installation is a good time to consider the possibilities.
Left, Top and Bottom Bars with PatternSkin
The top bar and bottom bar are common across all webs.
To customize the top bar, copy
System.WebTopBarExample to System.WebTopBar, and make your desired changes to System.WebTopBar.
To customize the bottom bar, copy
System.WebBottomBarExample to System.WebBottomBar, and make your desired changes to System.WebBottomBar.
The side bar can be customized on a per web basis. To customize the side bar, copy the WebLeftBarExample topic in the given web to WebLeftBar, and make your desired changes to WebLeftBar. If you would like to move the side bar to the right of the page, see
System.PatternSkin for more details.
Copyright, License and Classification Statements
At the bottom of each topic, there is a copyright statement that is set in the
WEBCOPYRIGHT
preference. Its default is the following:
Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
If your Foswiki site is used in an environment without public access you should replace this with your normal copyright notice. You should also consider adding a security classification (e.g., For Internal Use Only) so people do not have to add this manually to every new topic.
If your Foswiki site is publicly accessible, you need to decide which copyright and license you wish to apply to all contributions. For open source applications, licenses such as
the GNU Free Documentation License,
FreeBSD Documentation License, and one of the various
Creative Commons licenses are possible licenses to consider. Remember that once people have started contributing, you cannot retroactively change the license (unless it has a provision for this).
To change the copyright statement, perform the following steps:
- Copy the
WEBCOPYRIGHT
preference setting from System.DefaultPreferences to User.SitePreferences
. Change the value to your desired text. This value will be your new default across all webs.
- You can create a unique message for a specific web by setting the
WEBCOPYRIGHT
preference in the WebPreferences
topic for the given web. For example, you could add a confidential classification to a web that has restricted access.
- The
WEBCOPYRIGHT
preference setting in System.WebPreferences covers the documentation that comes with Foswiki, and should not be changed.
WYSIWYG vs Raw Edit
In Foswiki, the WYSIWYG editor is used by default in edit mode. An
Edit Raw link is available for those who prefer to edit the raw topic text.
If you prefer to use the raw text editor by default and have a separate WYSIWYG button, as in TWiki 4.1, then you can modify the templates that define the edit screen as described in
Foswiki:Support.FaqHowToMakeRawEditDefault.
Extensions
Foswiki:Extensions is an extensive library of
plugins for Foswiki that enhance functionality in a huge number of ways. A few plugins are pre-installed in the Foswiki distribution. There are several types of Extensions available:
- Plugins extend Foswiki functionality without altering the core code.
- Skins Skins overlay regular templates to give different looks and feels to Foswiki screens.
- Contribs and AddOns are any other Extension that provides added functionality beyond Plugins and Skins
Installing extensions
Extensions can be installed using any of several different methods:
- the configure web interface
- the generic shell installer
tools/extension_installer
- by manually downloading the extension zip or tar file
Caution: Users of the debian
.deb
packages should only use the debian tools when installing extensions.
The simplest way is to visit
configure:Extensions. Use the
Find More Extensions button to download and install additional extensions from the foswiki.org website. If you are behind a firewall or your server has no access to the Internet, you can also install plugins manually. Installation instructions for each plugin are located in its corresponding topic on
http://foswiki.org/. Additional documentation on Foswiki plugins can be found at
Foswiki:Support.PluginsSupplement.
When installing an extension from the
configure
interface:
- Even if available, local Extension installers and archives are not used
- The extension is downloaded from the configured archive
- The latest version of the Extension is always downloaded. There is no automatic means of downloading older versions.
- If the extension is already installed, a backup is taken to the
working/configure/backup
directory
- Dependencies on other Extensions are automatically resolved and installed
- Dependencies are downloaded from the same archive where the Extension was found. No additional searching is performed.
- The Extension is installed.
- By default, unless a collsion occurrs with an existing file, the Extension's topics will not be checked in to the revision control system.
- If previous topics or attachments are found, then the topic will be checked in under the Administrators user id.
- If the topics or attachments are flagged as
!noci
, disabling checkin, they will still be checked in if existing revision control files are found, suggesting that local modifications have occurred.
- CPAN dependencies and other external packages are not resolved and should be resolved manually
When installing extensions from the command line:
- The
_installer
package must be run from the root directory of the Foswiki installation.
- The Extension
_installer
module must be downloaded from the Extension repository. The extension archive will be downloaded if required.
- When the
_installer
is run, it will install the Extension and dependencies similar to the configure
interface except:
- You will be given the option to use local archives if available in the root of the Foswiki installation
- You will be given the option to resolve CPAN dependencies after the Extensions and dependencies are installed.
- Any other dependencies still need to be manually resolved.
When using either the web or shell instalation tools:
- After installation, the Extension
_installer
module is saved in working/configure/pkgdata
- A complete log of the actions taken by the installer is saved in
working/logs/configure/[NameOfExtension]-yyyymmdd-hhmmss-[Action].log
Plugins must be manually enabled in the Plugins section of the configure
page. In addition, some extensions also require configuration in this section.
The instructions for using the extensions installer from the shell are
retrieved by using the "usage" command:
tools/extension_installer usage
or
./SomePlugin_installer usage
perl working/configure/pkgdata/X509UserPlugin_installer usage
Usage as a custom installer:
X509UserPlugin_installer -a -n -d -r -u -c install
X509UserPlugin_installer -a -n uninstall
X509UserPlugin_installer manifest
X509UserPlugin_installer dependencies
Usage as a generic installer:
tools/extension_installer X509UserPlugin -a -n -d -r -u -c install
tools/extension_installer X509UserPlugin -a -n uninstall
tools/extension_installer X509UserPlugin manifest
tools/extension_installer X509UserPlugin dependencies
If command (install, uninstall ..) is not provided, default is to
install the extension.
Operates on the directory tree below where it is run from,
so should be run from the top level of your Foswiki installation.
Depending upon your installation, you may need to execute perl directly
perl tools/extension_installer ... or
perl X509UserPlugin_installer ...
"install" will check dependencies and perform any required
post-install steps.
"uninstall" will remove all files that were installed for
X509UserPlugin even if they have been locally modified.
-a means don't prompt for confirmation before resolving
dependencies
-d means auto-download if -a (no effect if not -a)
-r means reuse packages on disc if -a (no effect if not -a)
-u means the archive has already been downloaded and unpacked
-n means don't write any files into my current install, just
tell me what you would have done
-c means don't try to use CPAN to install missing libraries
"manifest" will generate a list of the files in the package on
standard output. The list is generated in the same format as
the MANIFEST files used by BuildContrib.
"dependencies" will generate a list of dependencies on standard
output.
Removing (uninstalling) extensions
Caution: When removing an extension, no dependency checking is performed.
- Dependencies are not removed
- Other Extensions dependent on the removed extension may become non-operational.
The web and command line interfaces can be used to uninstall extensions. When an extension is remove, the following occurs:
- The
_installer
package is used to recover the manifest. If it cannot be found locally, it will be downloaded from the configured extension repository
- A backup of the previously installed files per the manifest will be taken to the
configure/working/backup
directory
- Note: If download of the
_uninstaller
was required, the backup will be made per the current installer's manifest. It is preferable to always save the _installer
modules.
- The Extension files along with any
,v
revision control files will be removed, including the _installer
.
- Any additional files saved locally are not removed.
- A complete log of the steps taken is saved in
working/logs/configure/[NameOfExtension]-yyyymmdd-hhmmss-[Action].log
- Plugin modules are not automatically disabled in the configuration - they must be disabled manually.
Run the uninstall from the "root" of the Foswiki installation:
working/configure/pkgdata/SomeExtension_installer uninstall
Restoring a removed, or previous version of an extension
The backup can be extracted from the root directory of the Foswiki installation. The archive is taken "relative" to the root of the installation, so an
unzip
or
tar -xzf
of the backup file should be all that is required:
cd /root/of/foswiki
tar -zxvf * working/configure/backup/[Extension}-backup-[yyyymmdd]-[hhmmss].tgz
# or
unzip working/configure/backup/[Extension}-backup-[yyyymmdd]-[hhmmss].zip
TWiki Compatibility
Foswiki is 100% backwards compatible with TWiki
® markup up to and including TWiki 4.2.4. Existing TWiki webs, topics and attachments can be used with Foswiki without requiring any changes.
To support a seamless upgrade from TWiki, Foswiki ships with a plugin called
TWikiCompatibilityPlugin
. This plugin enables most TWiki extensions to work with Foswiki, without modifications. It also maps requests for legacy TWiki web topics to their Foswiki equivalents, as defined in
Foswiki:Development.TopicNameMappingTable. The
TWIKIWEB
and
MAINWEB
TWiki variables are also mapped to the new Foswiki macros
SYSTEMWEB
and
USERSWEB
.
If you are not upgrading an existing TWiki installation and do not plan to install plugins from the TWiki web site, it is recommended that you disable the TWikiCompatibilityPlugin in the
Plugins Section on the
configure
page.
If a plugin exists both in a TWiki version and a Foswiki version, it is strongly recommended that you use the Foswiki version, as this is coded to work optimally with Foswiki. As part of the Foswiki project, the Foswiki community is evaluating all of the extensions that are available for TWiki, and porting them over to the Foswiki name space. Many of them are being enhanced through the removal of bugs and security vulnerabilities, resulting in better, more functional extensions for Foswiki.
Web Acceleration (mod_perl, FastCGI, ...)
Foswiki is installed by default supporting standard CGI scripts as well as CLI access. For best performance, Foswiki can be accelerated using one of the several accelerators, however,
you must install the required Foswiki extension and host modules before enabling accelereation! See the listed extensions for more information.
Caution
- Ensure your site is fully configured and working before enabling either of these extensions. They can be challenging to configure.
- The ApacheConfigGenerator will help creating a valid configuration for these accelerators.
- Enabling the apache configuration without installing the pre-req modules and extensions will break your site!
- The core default extensions are well tested with web acceleration, other extensions can exhibit inconsistent behaviour when accelerated.
TWiki is a registered trademark of Peter Thoeny.