Manually Installing Extensions

Sometimes you need to be able to install extensions manually, from the command-line. This might be because the extensions hasn't been packaged using BuildContrib, or because you are having problems installing from configure (this can sometimes happen on hosted sites, or because the server configuration is unusual).

For Foswiki 1.1+

See InstallationGuidePart2#Extensions

For Foswiki 1.0.x

So install an extension manually:

1. Download one of the .zip or .tgz archives
2. Unpack the archive in the root directory of your installation.
3. Run the installer script
   • perl <module>_installer
   • If the installer script fails, keep going anyway. Some extensions don't need the installer script to run to completion to be correctly installed
4. Run configure
   • Enable the module if it is a plugin.
   • Set up any configuration options required for the extension
   • Save the configuration
5. Repeat for any missing dependencies.

Troubleshooting

If you are still having problems, then:

1. Make sure that the file permissions allow the webserver user to access all files.
2. Check in any installed files that have existing ,v files in your existing install (take care not to lock the files when you check in)
3. Manually edit LocalSite.cfg to set any configuration variables.