Many of DokuWiki's features can be configured through various config options. The easiest way to modify these options is using the Configuration Manager which allows wiki administrators to easily alter the wiki configuration settings online from the comfort of their favorite web browser.

To start the Configuration Manager log in as superuser and click the Admin button.

The “system” options of DokuWiki will be found in the conf/dokuwiki.php file. However this file contains the “default” values of the system. To customize it, you should edit the file conf/local.php or create it if it doesn't exist. To find what you can configure within that file, see the list of available options below.

User names, (encrypted) passwords and Access Control rules are stored in the users.auth.php and acl.auth.php.

When uploading a new file within the mediamanager, you may encounter a “Upload denied. This file extension is forbidden!” message. This behavior is controlled within the conf/mime.conf file. To upload a new type of file, specify it within the mime.conf file.

Some automatic replacements are done when you edit your pages. Some generate tooltips, smileys or some special chars. This behavior is controlled by the acronyms.conf, smileys.conf or entities.conf.

All configuration files are to be found in the ./conf folder or /etc/dokuwiki when installed from a Debian package.

“Main files” usually ship with DokuWiki, whereas “local files” have to be created by the wiki admin.

If local files are supported you should use them instead of modifying the main files to avoid upgrade troubles.

Additional configuration files are found in /var/lib/dokuwiki/lib/tpl/dokuwiki (Debian), e.g. style.ini. Style.ini is a text-file that is read by the default theme, and the user can configure e.g. the background-color.

Installed plugins are enabled by default. They could be disabled using the Extension Manager or Plugin Manager which writes to the plugins.local.php file. You can protect certain plugins by placing them in conf/plugins.protected.php.

By default DokuWiki loads its configuration files in the following order:

1. conf/plugins.php – default plugins
2. conf/plugins.local.php – changed by plugin manager
3. conf/plugins.required.php – these core plugins cannot be controlled by plugin manager
4. conf/plugins.protected.php – overrides setting in the other files

The loading order of configuration files is controlled by the global $config_cascade variable. By using a preload.php file you can change this behavior.

Most of DokuWiki's features can be configured through various config options. The easiest way to modify these options is using the Configuration Manager.

The available settings are listed below. Their default values are stored in a file called conf/dokuwiki.php. If you want to modify a setting you should do this in a file called conf/local.php – this makes sure your special configs are not overwritten by a later upgrade. The config manager will use this file as well. The file conf/local.protected.php can be used for configuration settings which cannot be modified.

Here is a sample conf/local.php:

<?php
$conf['title']     = 'Admin\'s Wiki';
 
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

Some notes about the config file. The file is a piece of PHP code so the PHP syntax has to be preserved. E.g. each line has to have a semicolon at the end. There are multiple types of variables:

• Numbers can be written as is. Example: 9
• Strings have to be enclosed in single or double quotes. Example: 'foo bar'
• Booleans can be either 1 or 0
• Arrays contain multiple values of one of the above types

• Basic Settings
  • title
  • start
  • lang
  • template
  • tagline
  • sidebar
  • license
  • savedir
  • basedir
  • baseurl
  • dmode
  • fmode
  • allowdebug
• Display Settings
  • recent
  • recent_days
  • breadcrumbs
  • youarehere
  • fullpath
  • typography
  • dformat
  • signature
  • showuseras
  • toptoclevel
  • tocminheads
  • maxtoclevel
  • maxseclevel
  • camelcase
  • deaccent
  • useheading
  • sneaky_index
  • hidepages
• Authentication Settings
  • useacl
  • autopasswd
  • authtype
  • passcrypt
  • defaultgroup
  • superuser
  • manager
  • profileconfirm
  • rememberme
  • disableactions
  • auth_security_timeout
  • securecookie
  • remote
  • remoteuser
• Anti-Spam Settings
  • usewordblock
  • relnofollow
  • indexdelay
  • mailguard
  • iexssprotect
• Editing Settings
  • usedraft
  • htmlok
  • phpok
  • locktime
  • cachetime
• Link Settings
  • target (wiki, interwiki, extern, media, windows)
• Media Settings
  • mediarevisions
  • gdlib
  • im_convert
  • jpg_quality
  • fetchsize
  • refcheck
• Notification Settings
  • subscribers
  • subscribe_time
  • notify
  • registernotify
  • mailfrom
  • mailprefix
  • htmlmail
• Syndication Settings
  • sitemap
  • rss_type
  • rss_linkto
  • rss_content
  • rss_media
  • rss_update
  • rss_show_summary
• Advanced options
  • updatecheck
  • userewrite
  • useslash
  • sepchar
  • canonical
  • fnencode
  • autoplural
  • compress
  • cssdatauri
  • gzip_output
  • send404
  • compression
  • broken_iua
  • xsendfile
  • renderer_xhtml
  • readdircache
• Network Settings
  • dnslookups
  • jquerycdn
  • proxy (host, port, user, pass, ssl)
  • safemodehack
  • ftp (host, port, user, pass, root)