DokuWiki のほとんどの機能は、様々な設定オプションを通じて設定することができます。これらの設定オプションを変更するもっとも簡単な方法は、サイト設定用プラグインを利用することです。

DokuWiki のシステム全体の設定項目は、conf/dokuwiki.php ファイルに格納されています。しかし、このファイルはシステムの「デフォルト値」を設定するためのものです。実際に設定項目を変更するには conf/local.php ファイルを編集すべきです (もしこのファイルが無い場合は作成してください)。このファイルの中で設定できる設定項目については、このページの下部にある利用可能なオプションのリストをご覧ください。

ユーザ名および (暗号化された) パスワード、アクセス制御ルールについては users.auth.php と acl.auth.php ファイルに保存されています。

メディアマネージャーから新しいファイルをアップロードする際に「アップロードは拒否されました。この拡張子は許可されていません。」というメッセージを目にするかもしれません。この振る舞いは conf/mime.conf ファイルで制御されています。新しい種類のファイルをアップロードするには mime.conf ファイルの中で定義してください。

ページが編集された際はその内容に対していくつかの自動的な変換が行われます。略語を説明するためのヒントの生成や、スマイリーや特殊文字への変換などです。これらの振る舞いは、それぞれ acronyms.conf、smileys.conf、entities.conf ファイルで制御されます。

すべての設定ファイルは ./conf ディレクトリの中にあります。

「メインファイル」は DokuWiki に同梱されていますが、「ローカルファイル」は Wiki の管理者が作成する必要があります。

もしローカルファイルがサポートされている場合は、バージョンアップ時のトラブルを避けるため、メインファイルではなくローカルファイルを編集するようにしてください。

インストール済みのプラグインはデフォルトで有効化されます。 拡張機能管理やプラグイン管理を使って plugins.local.php ファイルに記録することで無効化できます。 conf/plugins.protected.php に記載することで特定のプラグインを保護することもできます。

DokuWikiは、デフォルトで次の順序で設定ファイルを読み込みます：

1. conf/plugins.php – デフォルトのプラグイン設定
2. conf/plugins.local.php – プラグイン管理で変更
3. conf/plugins.required.php – この同梱プラグインは、プラグイン管理での制御不可
4. conf/plugins.protected.php – 他のファイルの設定よりも優先

設定ファイルの読込み順は、$config_cascade グローバル変数によって制御されています。 プリロードファイルを使用して、この動作は変更可能です。

DokuWiki のほとんどの機能は様々な設定オプションを通じて設定することができます。これらの設定オプションを変更するもっとも簡単な方法は、サイト設定用プラグインを利用することです。

利用可能な設定オプションは、次のセクションで示します。設定オプションのデフォルト値は conf/dokuwiki.php ファイルに格納されています。もし設定を変更する場合はこのファイルを直接編集するのではなく、conf/local.php ファイルを編集するべきです。conf/local.php ファイルのみを編集するようにしておけば、後で DokuWiki のバージョンアップを行った場合でもあなた独自の設定が上書きされる心配はありません。なお、サイト設定用プラグインも conf/local.php ファイルを編集する仕組みとなっています。

以下に conf/local.php ファイルのサンプルを示します。

<?php
$conf['title']     = '管理者の Wiki';
$conf['useacl']    = 1;
$conf['superuser'] = 'admin';

設定ファイルについて、いくつかの注意を以下に示します。設定ファイルは PHP スクリプトとして取り扱われますので、PHP の文法を守らなければなりません。例えば、行末にはセミコロン (;) を付けるなどです。設定項目には数種類の型があります。型について、以下に説明します。

• 数値は、値として数字を取ります。例: 42
• 文字列は、シングルクォート (') もしくはダブルクォート (") で囲まなければなりません。例: 'ほげ ふが'
• 真偽値は、値に 1 もしくは 0 を取ります (設定の都合上 true と false は使用しないでください)。
• 配列は、上記の型の値を複数個含みます。

• 基本設定
  • title
  • start
  • lang
  • template
  • tagline
  • sidebar
  • license
  • savedir
  • basedir
  • baseurl
  • dmode
  • fmode
  • allowdebug
• 表示設定
  • recent
  • recent_days
  • breadcrumbs
  • youarehere
  • fullpath
  • typography
  • dformat
  • signature
  • showuseras
  • toptoclevel
  • tocminheads
  • maxtoclevel
  • maxseclevel
  • camelcase
  • deaccent
  • useheading
  • sneaky_index
  • hidepages
• 認証設定
  • useacl
  • autopasswd
  • authtype
  • passcrypt
  • defaultgroup
  • superuser
  • manager
  • profileconfirm
  • rememberme
  • disableactions
  • auth_security_timeout
  • securecookie
  • remote
  • remoteuser
• スパム対策設定
  • usewordblock
  • relnofollow
  • indexdelay
  • mailguard
  • iexssprotect
• 編集設定
  • usedraft
  • htmlok
  • phpok
  • locktime
  • cachetime
• リンク設定
  • target (wiki, interwiki, extern, media, windows)
• メディア設定
  • mediarevisions （未訳）
  • gdlib
  • im_convert
  • jpg_quality
  • fetchsize
  • refcheck
  • refshow
• 通知設定
  • subscribers
  • subscribe_time（未訳）
  • notify
  • registernotify
  • mailfrom
  • mailprefix（未訳）
  • htmlmail（未訳）
• RSSフィード設定
  • sitemap
  • rss_type
  • rss_linkto
  • rss_content
  • rss_media （未訳）
  • rss_update
  • rss_show_summary
• 高度な設定
  • updatecheck
  • userewrite
  • useslash
  • sepchar
  • canonical
  • fnencode
  • autoplural
  • compress
  • cssdatauri
  • gzip_output
  • send404
  • compression
  • broken_iua
  • xsendfile
  • renderer_xhtml
  • readdircache
• ネットワーク設定
  • proxy (host, port, user, pass, ssl)
  • safemodehack
  • ftp (host, port, user, pass, root)