This page creates an Apache configuration file foswiki.conf for your installation.
Fill out the form, and then press the button "Update Config File".
Copy and paste the generated configuration into your Apache configuration file.
For setting up Foswiki on Linux or Unix, see also SettingFileAccessRightsLinuxUnix? .
Debian Users:
If you used the Debian packages to install Foswiki, do not use the ApacheConfigGenerator? .
Use the configuration files included in the .deb packages..
If you can't edit http.conf.:
Some people, including many using web hosts, can't edit http.conf.
If this applies to you, do not bother using this page - edit the various .htaccess template files included in the download (They have instructions in them. Their filenames are all different, but include "htaccess.txt" in them.).
default foswiki.conf
Press the "Update config file" button to generate your custom config
By pressing the button below you select all the text in the textarea. Then you just need to copy the text to the clipboard and paste it into the foswiki.conf file.
Comments
"AddType text/plain .shtml .php .php3 .phtml .phtm .pl .py .cgi"
Be aware that this directive introduces an issue if for example you have the associated html page for the wysiwyg editor. as the text/html document will have text/plain mime type. Maybe wise to limit the coverage of the directory or location.
History
removed the handy W3C? tools from the blocked list. -- WillNorris - 18 Feb 2009
ending % was missing for a %PATHURL in a ScriptAlias? declaration -- ColasNahaboo - 23 Feb 2009
Noted can't use a configure user as an editing wiki user -- MartinCleaver - 23 Mar 2009
Remove /bin/view from the ErrorDocument? strings if shorturls enabled - otherwise Apache fails to prompt for password - 5 Apr 2009
Disabled TinyMCE? plugin as it messes up with the layout -- OlivierRaginel - 06 Apr 2009
Reorganized, added support for protecting attachments, FollowSymLinks? -- GeorgeClark - 11 Apr 2009
Simplified viewfile regex - should fix compile failure on Apache startup.
Allow any wiki topic to be specified as the not-authorized page
Allow location of .htpasswd to be overridden
Add an optional port # for the Virtual host. So you can specify :80, :443, or whatever on the statement.
Fixed htpasswd to default to data directory if left blank, otherwise overrides path - 3 Sept 2009
Added (commented out) rules for serving pre-compressed .js and .css -- MichaelTempest - 22 Sep 2009
Moved LocationMatch for fcgi outside of the directory.
Add an Alias statement for robots.txt when short URLs are enabled
Add or/and configuration of access control to bin/configure command -- TobiasVonDerKrone - 11 Dec 2009
Fixed the urlpath element so that it roundtrips without adding a bogus leading space -- MartinCleaver - 11 Feb 2010
Wanted improvements.
For ShortURLs? , I had to (at least for what I'm doing at SSLForNonViewScriptsOnly), add Alias /error/ "/usr/share/apache2/error/" above Alias / "/srv/www/vhosts/wiki.trin.org.au/foswiki/bin/view/"
Handle modules needed for LDAP library inclusions -- MartinCleaver - 11 Feb 2010
Template Login should be enable by default on "Choose your Login Manager".
There should be a really basic configuration file ready to download and explained for newbies.