group Next Big Thing: Register for the Foswiki Camp 2015 ... Upcoming this week! Wednesday 25th March to Friday 27th March 2015

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 System.InstallationGuide#Installing_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.


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.

BasicForm edit

TopicClassification SupplementalDoc
Topic Summary Describes how to install extensions from the command-line
Interested Parties
Related Topics
Topic revision: r3 - 18 Sep 2012, PaulHarvey

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. see CopyrightStatement. Creative Commons License