DokuWikiのインストールはとても簡単――通常はファイルを解凍してパーミッションを設定するだけで使えますが、ここではいろんな環境に対応する方法の詳細をご説明します。

ステップ１: ダウンロードページ から最新版1)をダウンロードします。ここまでの手順は誰でも同じです。

ステップ２: 使っているプラットフォームに応じたそれぞれの説明にしたがって作業してください。

基本のインストール作業の直後の箱から出したままの状態のDokuWikiは次のような動作をします。

• そのままではまだ動きません。 “changes.log” という名前の空のファイルを/dataディレクトリに作って、そのファイルに書き込み可能なパーミッションを設定する必要があります。これがないと “changes.log does not exist or isn't writable.” といったエラーが出ます。
• この他のディレクトリでも同様の問題が起こります。 “metadir does not exist or isn't writable. Check config!” とか “mediadir does not exist or isn't writable. Check config!” というエラーが出た場合は、/dataディレクトリの下に指摘されたサブディレクトリ（この場合mediaやmeta）を作ってください。この他の必要なディレクトリの名前は '/inc/init.php' ファイルの中を参照してください。
• アクセスコントロール機能が動いていません（Authentication Options参照）
• 誰でもページを読め、編集でき、作成できる状態になっています（Permissionlevels参照）
• （上記の『ディレクトリやファイルがない』という問題は将来の新しいバージョンでは修正したいと思っています。提案：必要な空のファイルとディレクトリをあらかじめアーカイブファイルの中に入れておく。可能か？あるいは、スペース1つだけが入ったファイルを入れる？

これは企業内サーバーなどroot権限を持っているサーバーにDokuWikiをインストールする場合など、もっとも通常の方法です。

• Apache（Webサーバー）とPHPがインストールされていることを確認してください（たいていのGNU/LinuxディストリビューションはApacheとPHPが標準装備されています）――それぞれのバージョンがDokuWikiに対応していること。
• Webサーバーのドキュメントルートの下のどこかにDokuWikiのtarボールファイルを展開します。例：

#> cd /var/www/
#> tar -xzvf /path/to/downloaded/dokuwiki-YYYY-MM-DD.tgz

• できたディレクトリを好きな名前に変えます

#> mv dokuwiki-YYYY-MM-DD dokuwiki

• 空のログファイルを作ります

#> touch dokuwiki/data/changes.log

• アクセスコントロール（ACL）機能を使いたい場合は、users.auth.phpとacl.auth.phpというファイルを作ります。 (just a user, TL)

#> cp dokuwiki/conf/users.auth.php.dist dokuwiki/conf/users.auth.php
#> cp dokuwiki/conf/acl.auth.php.dist dokuwiki/conf/acl.auth.php

• ファイルのパーミッションを正しく設定します
  • 通常、Webサーバーのプログラムは nobody 、 www-data 、 apache といった特権なしの特別なユーザー名で動作しています
  • DokuWikiが使うファイルやディレクトリの中にはWebサーバーが書き込みができるようにパーミッションを設定する必要があるものがあります（ですから下の例の chown nobody という部分などは、サーバーの設定にあわせて読み替えてください。例えば chown apache といったように）
  • アクセスコントロール機能を使う場合は、ファイルのグループオーナーもWebサーバーが属するグループが書き込めるように変更する必要があります（ユーザーとWebサイトの管理者であるあなたも直接ファイルを編集できるようにするためにグループオーナーを使います）――これを設定しないと、ユーザー登録ができなくなり、あなた自身もWebブラウザからACLの設定ができなくなります。私自身、ACL機能を使ったサイトをインストールするときによくこの設定を忘れてしまうので、ここでご説明しています。
  • Webサーバープログラムが属しているグループの名前は通常はユーザー名と同じか “nobody/nogroup” の組み合わせですが、念のためあなたのサーバーの設定がどうなっているか確認してください (just a user, TL)

#> chgrp nogroup dokuwiki/conf/users.auth.php
#> chgrp nogroup dokuwiki/conf/acl.auth.php

#> chown -R nobody dokuwiki/data

• その他、必要に応じて dokuwiki/conf/dokuwiki.php （設定参照）ファイルを編集します。あるいは、 dokuwiki/conf/local.php というファイルを作って、その中に dokuwiki.php から変更したい行だけを抜き出して書き込みます。こうしておくと、新しいバージョンのDokuWikiをインストールするときに、 dokuwiki.php を上書きしてもあなたが追加した変更はそのまま引き継がれます
• 最後に、設定がすべて正しくできたか確認します。DokuWikiのURLの後ろに check オプションをつけてブラウザで開きます: http://127.0.0.1/dokuwiki/doku.php?do=check

• アクセスコントロール機能を使うときは、自分がログインしたときに画面に “管理” ボタンが表示されるようにするために、自分自身を管理者として指定する必要があります（dokuwiki.phpかlocal.phpの中で、管理者として自分のユーザー名を指定、あるいは管理者グループとして指定したグループの中に自分のユーザー名を登録します。 (just a user, TL)

• まれに、chownがうまく効かない場合があります。そのときは、dataディレクトリをchownするかわりにchmodして書き込めるようにします
• .htaccessファイルでの指定がエラーを起こす場合があります。 'Internal Server Error 500' が出て、どんな単純なPHPプログラムも動かないといった症状です。その場合は.htaccessファイルの名前を変えるか削除すると直ります。

Matti Pölläによる公式Debian用パッケージがaptのtestingとunstableセクションからフェッチできます。この.debのホームページはhttp://packages.debian.org/unstable/web/dokuwikiです。

Ubuntuでは、”universe”からDokuWikiをインストールできます。インストールの方法は https://wiki.ubuntu.com/UniversePackagesをご覧ください。インストールができたら、このガイドの説明にしたがって設定できます。apt-getコマンドは”sudo”を使ってrootの権限で使用しないといけないことにご注意ください。

DokuWikiのインストールはDebianの通常の手順で行います。

#> apt-get update
#> apt-get install dokuwiki

これでパッケージが展開され、debconfからの質問にいくつか答えると完了です。ブラウザからDokuWikiを開けます。例えば、Webでのアクセスの場所を /dokuwiki にして、localhostからのみアクセスできると指定した場合、http://localhost/dokuwikiでスタートページが表示されます。

パッケージのバグを見つけたときはDebianのバグトラッキングシステムhttp://www.debian.org/Bugs/にレポートしてください。

FreeBSDのportsからDokuWikiをインストールするには次のようにします：

#> cd /usr/ports/www/dokuwiki
#> make install clean

DokuWikiをインストールするディレクトリはデフォルトでは/usr/local/www/data/dokuwikiとなっています。 もちろん、インストール先を別のディレクトリにしたり、別の場所へシンボリックリンクを張ることもできます。

Portsでのアップグレードは：

#> portupgrade dokuwiki

Ports treeが新しい物に更新されている必要があります。そうでないと、何も起こりません。

くわしくはHOWTO for DokuWiki on Tigerを参照してください。

このHOWTOは大変役に立ちますが、少し内容が古いようです。

私がTiger（古いDokuWikiはインストールされていない環境）にインストールしたときは次のような手順でした：

1. Mac OS XでPHPを有効にする （Personal Web Sharingの起動も）
2. dokuwiki-2005-07-13.tgzをダウンロード （ダウンロード先は~/Desktop）
3. コマンドラインから:

   $ cd ~/Desktop && tar -zxvf dokuwiki-2005-07-13.tgz
   $ mv dokuwiki-2005-07-13 ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ touch data/changes.log
   $ sudo chown -R www data

4. アクセスコントロールを使いたい場合は（conf/local.phpでuseaclの設定を変えて）、コマンドラインから：

   $ cp conf/users.auth.php.dist conf/users.auth.php
   $ sudo chown www conf/users.auth.php
   $ cp conf/acl.auth.php.dist conf/acl.auth.php
   $ sudo chown www conf/acl.auth.php

5. 重要：conf/local.phpで

   $conf['basedir']     = '/~user/dokuwiki/';

   と設定すること。ディレクトリの自動検出はうまく動きません。

## 10.4.3 クライアントで、標準装備のApacheを走らせて、サイトを/Library/Webserver/Documentsに設定（サーバーのふりをさせるため）した場合、'basedir'を指定すると壊れてしまった（訳注：ここ意味不明）

デスクトップ機でDokuWikiを動作させたい方向け

• ApacheとPHPをインストールしてください 2)
• DokuWikiのtarボールのファイルをWinZIPやオープンソースの展開ソフト7-Zipなどのツールで展開します。ファイルの展開方法についての詳しい説明は後述。
• dokuwiki-YYYY-MM-DDディレクトリを、インストールしたWebサーバーのドキュメントルート（例：c:\xampp\htdocs\）の下のどこかに移動し、名前をdokuwikiに変更します
• dokuwiki/data/ディレクトリの中にchanges.logという名前の空のファイルを作ります（右クリックしてから、新規作成 → テキスト ドキュメント。その後できたファイルの名前を変更）。
• confディレクトリの中のdokuwiki.phpファイルを編集してDokuWikiの設定を変更する（設定参照）か、conf/local.phpという新しいファイルを作り、dokuwiki.phpの中の変更したい行だけを抜き出したものをその中に記入します。後者の方法は新しいバージョンのDokuWikiを上書きインストールしたときにdokuwiki.phpが書き換わっても、あなたが変更した設定はそのまま残りますので、お薦めです。
• http://127.0.0.1/dokuwiki/doku.phpであなたのWikiが見えるはずです。

dataディレクトリの中にatticというディレクトリを作らないといけない場合もあるようです。同様に、場合によってはdata/cache、data/meta、data/locksというディレクトリも手動で作る必要があります。

IISが使えるWindows機（Windows 2000、Windows XP、Windows Server 2003）でDokuWikiを使いたい方向けz

• PHPをインストールしてください。PHPのサイトにインストールプログラムやパッケージについての説明があります。 PHPはCGIプログラムとして動かすことも、ISAPI拡張プログラムとして動かすこともできます。
• DokuWikiのtarボールのファイルをWinZIPやオープンソースの展開ソフト7-Zipなどのツールで展開します。ファイルの展開方法についての詳しい説明は後述。
• dokuwiki-YYYY-MM-DDディレクトリの名前をdokuwikiに変更して、次のどこかに移動します
  • Webサーバーのドキュメントルート（例：c:\inetpub\dokuwiki）の下のどこかに移動します
  • その他、どこか任意の場所に移動して、そのディレクトリにバーチャルディレクトリをマッピングします
• In the dokuwiki/data/ directory create a new empty file named changes.log, and create the folders attic/, meta/, locks/ and cache/
• Edit the dokuwiki.php file in the conf directory to configure your Wiki (see 設定) or (better) create a new conf/local.php file containing those lines from dokuwiki.php, which you want to change. This way your changes are preserved when overwriting the dokuwiki.php with a new release.
• Your new Wiki should be available at http://localhost/dokuwiki/doku.php

Windows-Users may need to rename the file from dokuwiki-YYYY-MM-DD.tgz to dokuwiki-YYYY-MM-DD.tar.gz to make their archive tool recognize the file format correctly (See 209).

The windows file extension is now .tar - however renaming it and using winzip works just fine.

Extraction Programs:

• Windows zipping and compression program, WinZIP
• Opensource file archiver, 7-Zip
• For Windows and other platforms, free Ultimate Zip worked fine for me in unpacking dokuwiki.tgz.
• Use the amazing TotalCommander, it handles tgz and FTP perfectly.

NanoWeb is a PHP-based web server, and much lighter in its memory footprint than something like Apache. Nagios and Double Choco Latte both work fine, as does DokuWiki.

However, after following the instructions as described above for use with the Apache web server, it will be necessary to modify dokuwiki.php, as it does not automatically detect its web server location (URL).

Autodetection of an URL is not possible in all thinkable environments. Especially not when extensive URL rewriting and other forwarding mechnisms are in use. Furthermore the word “relative dir” is a bit missleading. Because dokuwiki requires an absolute pathname here. So start with a slash and end with a slash as in the example below. – Doogie - 27. May 2005

Change the line:

$conf['basedir'] = '';           //relative dir to serveroot - blank for autodetection

to something like:

$conf['basedir'] = '/dokuwiki/'; //relative dir to serveroot - blank for autodetection

Note that, for whatever reason, a trailing slash is required!!

レンタルサーバーをお使いの方はほとんどこれに該当します

このタイプのサーバーへのインストールの英語版のScreencast（動画デモ）もご覧ください。

• ダウンロードしたtarボールのファイルをローカルのパソコンのハードディスク上に展開します 3)。
• dokuwiki-YYYY-MM-DD/dataディレクトリの中にchanges.logという空のファイルを作ります。
  • Windowsの場合: Explorerでマウスを右クリックし、新規作成 → テキスト ドキュメントでファイルを作成してからファイル名を変更
• confディレクトリの中のdokuwiki.phpファイルを編集してWikiの設定を変更（設定を参照）するか、conf/local.phpという新しいファイルを作って、その中にdokuwiki.phpの中から変更したい行だけを抜き出したものを書き込みます。後者の場合、DokuWikiの新しいバージョンを上書きインストールしても、あなたが設定した変更内容はそのまま保存されるので、こちらがお勧めです。
• お好みのFTPツールを使ってdokuwiki-YYYY-MM-DDディレクトリの中身をそのままWebサーバーにアップロードします。このとき、dokuwiki-YYYY-MM-DDというディレクトリの名前をdokuwikiなどお好みのものに変えてください。
• ホスティング会社のFTPサーバーの設定によっては、このままですでにDokuWikiが使える状態になっているかもしれません ― 次のようにURLの後ろにcheckオプションをつけてDokuWikiのページを開いてみます： http://www.example.com/dokuwiki/doku.php?do=check
• 赤い警告メッセージが出ている場合は、FTPプログラムを使ってファイルのパーミッションを変更する必要があります。
  • FTPプログラムでファイルのパーミッションを変更するオプションはたいていchmodという名前がついていて、メニューのどこかに隠れていたり、ファイルを右クリックすると使えたりします。
• いちばん単純な設定は、dokuwiki/data/ディレクトリとその中の全部のファイルとディレクトリのパーミッションをrwxrwxrwxあるいは777に変更することです。
• その前に、まずrwxrwx---あるいは770というパーミッション設定を試してみるのがよいでしょう。―このほうがセキュリティ上より安心な設定ですが、ホスティング会社のサーバーの設定によってはこのパーミッションではDokuWikiがうまく動作しないこともあります。

You can also check out the newest development version using darcs.

Before upgrading, you should always read the changelog to see if something changed you should be aware of when upgrading. To determine the version you are running, have a look in the HTML source of a Page generated by DokuWiki there should be something like <meta name=“generator” content=“DokuWiki 2005-02-06” /> 4).

Some reminders! I tried to upgrade from 2005-05-17 to 2005-07-13, and had problems with plain ACL. This has been discussed at http://wiki.splitbrain.org/wiki:discussion:acl?s=users%5C.auth#user_registration_-_can_t_register . I was in the process of reverted to 2005-05-13, and decided to give another try, which appears to have been successful. Two hints: (a) when transferring files over to the updated program directory, make sure that the chmod is set to 777 for all of them, or they won't be editable!; and (b) when updating configuration files, remember to use a UTF-8 editor if you're on Windows! (I use Crimson Editor). {David Ing, 2005/07/17}

The easiest way to upgrade is perform the following steps

• Move your old installation to a backup directory
• Install the new Version as described above
• Copy your changes.log and the contents of your data/ (perhaps not the wiki/ directory), attic/ and media/ directories from the backup location to the new install dir
  • As of 2005-07-01, …
  • … changes.log (which was in the root directory) is now in the data/ directory;
  • … the user-created content that was in the data/ directory is now in the data/pages/ directory; and
  • … the attic/ and media/ directories that were in the root directory are now under the data/ directory.
• Copy your old conf/local.php from the backup location to the new install dir
  • If you had originally edited .htaccess in the root directory for dokuwiki to have “nice URLs”, you should replace the overwritten file from the prior installation. (It's a hidden file!)
• Copy your user.auth.php and acl.auth.php in conf/ if you use acl
  • These are new files for version 2005-07-13, so you'll have to copy the contents of user.auth into user.auth.php and acl.auth into acl.auth.php. If you're using Windows, remember to use an editor that saves in UTF-8 Unix format, such as Crimson Editor.
• Try the doku.php?do=check to find out if permissions have changed. On a hosted wiki, the following error messages are evidence that you haven't done chmod at the directory level (let alone the file level!)
  • Changelog is not writable
  • Datadir is not writable
    • This was because the data/pages/ directory was new for 2005-07-01
  • Attic is not writable
  • Mediadir is not writable
  • Cachedir is not writable

If you have made any changes on interwiki or smiley configurations or the source code itself, you will probably want to reapply them after upgrading.

When you upgrade from a version prior to 2005-02-06, you will need to convert your data to UTF8 after upgrading.

If you encounter some inconsistencies in DokuWikis behaviour after upgrading, you should delete the cache files in data/.cache/ and media/.cache/. You should make sure your browser hasn't cached an old stylesheet, too.

Example Upgrade Process

This method is not official - i (redeeman, visitor) just thought it would be nice to present this method of upgrade, which i just have used myself to upgrade from 2005-07-01 to 2005-07-13.

the thing i do, is to use diff, a command to generate a patch, this should be present on almost any unix system, however, it is probably also possible to find a win32 version on google.

now all we do to create the patch is to unpack the two different versions, so we get the dirs: “dokuwiki-2005-07-01” and “dokuwiki-2005-07-13” (this is the version change i did, your upgrade might be from/to different versions). now all we need to do is issue the diff command, and create the patch:

diff -Naur dokuwiki-2005-07-01 dokuwiki-2005-07-13 > doku.diff

now we have the patch, this is essentially only the differences between the two directories (e.g it knows nowthing of your pages, which is good) and you should be able to patch up, without it interfering with anything. however, you should not, that it might have changes in the conf/ dir in files you have edited, in which case you should do a backup of the file, copy the file from the version you already have, so the patch will work, and then when the patch is applied redo your changes, however this is only the case if changes to the dokuwiki standard php file is in an upgrade.

To check which files the patch will affect, you can run with –dry-run.. just cd into the dir where dokuwiki is installed, and run:

patch -p1 </path/to/doku.diff --dry-run

then if you accept it :) just run it like this, without –dry-run:

patch -p1 </path/to/doku.diff

Example of everything needed for this

無事すべての設定が終わって動き始めたら、次にやるべきことは次のとおりです。

• セキュリティ対策のパッチが出ていないか、securityのページを確認します
• modrewriteを使うかどうかを決めます
• 自分が作るコンテンツのライセンスポリシーを決めます – 選んだライセンスポリシーに合わせて/dokuwiki/lib/tpl/defaultディレクトリのfooter.htmlを変更します
  • Creative Commons Attribution-NonCommercial-ShareAlike License（既定の設定はこれ）
  • GNU Free Documentation License
• Apacheを使っている場合は、.htaccessのURL書き換え（URL rewrite）オプションを有効にして、設定ファイル（/conf/dokuwiki.phpまたは/conf/local.php）もURL書き換えを利用するように修正します
• お好みに合わせて/lib/tpl/defaultディレクトリの中のdesign.cssとlayout.cssを修正します
• Enter a few words how and where you use DokuWiki in the userpage
• subscribe to DokuWiki at freshmeat.net to stay informed of updates and get a mail whenever a security problem is encountered.

The topic of multi-wiki, or wiki farms, comes up briefly in freelists.org archives, in this thread, this thread, and this one. In the last one, Andi describes changes he made so $conf['title'] can be used to establish different cookies for separate installations.

Note that namespaces could be used to separate content in a single installation. And multiple installation means each one will need its own upgrade. It is not the same as multiple instances sharing common code. Package upgrades, like Debian’s, will not handle multiple installations. But for some this is a price worth paying. Here is an approach that worked with the GNU/Linux installation using Apache. It can probably be adapted to the other situations:

1. Do the regular installation, and test it.
2. Create conf/local.php with the title line and any other lines you want to tailor.
3. Copy the folder “dokuwiki” and give it a name suggesting its content.
4. Set $conf[’title’] in local.php of new folder, to title and differentiate the installation.
5. If the new folder is named “newwiki,” bring up http://localhost/newwiki.

Do the first two steps once and repeat the last three to make multiple installations.