Next step: %IGStepNextText%Up: Configure the web server
Installing Foswiki: Choosing between a config file or .htaccess file
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 is included from the main Apache config file http.conf. 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
). 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.
Next step: %IGStepNextText%Up: Configure the web server
Customized versions of
InstallStepChooseApacheConfig: