Next step: Enable authentication of users (if desired)
Previous step: Configure the web server
Up: Overview

Installing Foswiki: Configure Foswiki

*Updated for Foswiki 1.1.4*

Run the configure script from your browser: enter http://localhost/foswiki/bin/configure into your browser address bar.

  • You will typically get an error in the Web Server Environment tab Error: No writable system temporary directory. This should be automatically resolved when you save the settings.

  • You will also have 11 warnings in the General path settings section. Open the General path settings section. Configure should have guessed all the directories correctly. Verify that the paths are correct. All paths set in configure must use forward slashes instead of backslashes. Also if you requested "short URLs" in the Apache Config Generator, you should "blank out" the setting for {ScriptUrlPaths}{view}

Click the Save Changes button.

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 step "Define the administrator users").

Enter a new password, confirm and click Set password and Save Changes button.

Now you should get 52 errors in the Store Settings section. Fixed in Foswiki 1.1.4

You will have 1 warning in the Security Setup section, and 2 errors and 2 warnings in the Mail and Proxies section.

Security and Authentication -> Login
Ignore the warning about no password file.
Security and Authentication -> Passwords Tab
We strongly recommend that you choose some other encryption method than crypt. sha1 is a good choice for Windows.
Mail and Proxies -> Email General Tab
Enter a valid email address for the {WebMasterEmail} tab.
Mail and Proxies -> Email Server Tab
Verify the server setup
  • {Email}{MailMethod} will have been guessed as Net::SMTP If you plan to use Gmail or if your mail host provider requires, choose Net::SMTP::SSL
  • {SMTP}{MAILHOST} must be configured with the hostname of your email server. If using gmail, the correct setting is smtp.gmail.com:465
  • If your mail provider requires authentication, set the {SMTP}{Username} and {SMTP}{Password} fileld.

Click the Next button, provide your password and save.

Before proceeding, visit the "Mail and Proxies -> Email Test" tab. Press the Test button to verify your email configuration is operational, or it will not be possible to register users on your site.


Steps required on Foswiki 1.1.3 or older.

Click the Yes, I've read all the documentation button at the top of the page. Go to the Store Settings section and select the option RcsLite for {StoreImpl}. Guessed correctly in Foswiki 1.1.4

Search for the {RCS}{SearchAlgorithm} option in the Store settings section and select Foswiki::Store::SearchAlgorithms::PurePerl. Guessed correctly in Foswiki 1.1.4

Next step: Enable authentication of users (if desired)
Previous step: Configure the web server
Up: Overview

Topic revision: r2 - 26 Oct 2011, GeorgeClark
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