It's better when it's simple

User Tools

Site Tools


Freshly installed plugin doesn't work

:?: I just installed a new plugin, but it doesn't work at all.

:!: The best way to install most plugins is using the Extension Manager. That way you will have the least problems.

If you installed a plugin manually (i.e. extracted it into your wiki's plugin folder) or are using an older version of DokuWiki, the following might help to refresh parts of the wiki.


  • Make sure DokuWiki's cache gets purged by resaving the Configuration Manager via admin menu, or by touching your conf/local.php (also toucher plugin).
  • Make sure to bypass your browser's cache and force a reload of the relevant page (with Ctrl-F5, Shift-F5, Ctrl-Shift-R, or similar).
  • As a last resort, you may wish to delete the contents of the <dokuwiki>/data/cache/ on your server. This has worked in the past.


  • A few plugins have dependencies (either other plugins need to be installed or some external applications). Check the instructions on the plugin's page if you have installed all required modules.
  • Not all plugins work with all DokuWiki versions. Check on the plugin's page if it mentions any compatability information.

Other hints

  • Some download files (zip, tgz, etc) contain an incorrect file structure (sometimes due to automated zipping on hosted repositories like Check that there is a folder with the exact plugin's name, e.g. the plugin “gallery” should be in the folder named “gallery” (under ./lib/plugins/gallery). If the folder name is different, you should rename it to its correct name.
faq/pluginproblems.txt · Last modified: 2020-10-17 17:52 by Dr-Yukon

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki