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: