Next step: %IGStepNextText%
Up: Configure the web server

Installing Foswiki: Using an Apache config file

The easiest and best way is to use the Foswiki:Support.ApacheConfigGenerator tool to generate a safe, working foswiki.conf 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.

In the foswiki.conf file, ensure that web access is denied to all Foswiki subdirectories other than bin and pub. The Foswiki:Support.ApacheConfigGenerator tool will generate the appropriate settings; the foswiki_httpd_conf.txt file also has examples of configuring Apache appropriately.

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.

Copy the foswiki.conf file to your Apache conf/ directory. Edit the Apache conf/httpd.conf file to contain the following directive:
Include conf/foswiki.conf

Note: you must restart Apache after making changes to your config files for the changes to take effect.

Next step: %IGStepNextText%
Up: Configure the web server

  • Set IGVariant =

Customized versions of InstallStepApacheConfigFile:

Topic revision: r3 - 25 Jan 2010, IsaacLin
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