注意：如果您通过 Linux 发行版的软件包管理器（例如使用 Debian 或 Fedora 软件包）或类似工具安装了 DokuWiki，您还应该使用相同的软件包管理器来升级您的 DokuWiki。此页面上的说明仅适用于 install 页面上所述的标准手动安装。

DokuWiki的升级非常简单。它的文件布局避免了覆盖任何用户存储文件，这意味着升级通常只需要在旧版本之上解压新版本(就是覆盖)。您应该首先尝试此处给出的简单说明，如果您遇到问题或说明对您来说不够详细，请阅读以下部分中的详细信息。Mac 用户应使用终端;通过 Finder 复制文件将删除所有数据。

确定所运行的升级程序版本，在dokuwiki html源代码中有类似

<meta name="generator" content="DokuWiki 2005-02-06" />

这样的标记.

以下是简单的升级步骤：

• 步骤 0: 确保您的服务器满足 要求。
• 步骤 1:制作您的DokuWiki的备份，这并不是必须的步骤，但是还是建议您进行备份，数据无价。
  • 例子:
    

    tar zcpfv dokuwiki-backup.tar.gz /path/to/dokuwiki

• 步骤 2: 阅读 更新日志 以查看是否有任何特殊注意事项需要进行考虑。
• 步骤 3: 从 下载站 下载最新版本。

• cd ~
  wget http：//.../dokuwiki-xxxx-xx-xx.tgz

• 步骤 4: 解压文件压缩包，并在以前的安装文件夹中上传/复制文件。确保在出现提示时覆盖所有文件。

• tar zxvf dokuwiki-xxxx-xx-xx.tgz
  'cp' -af dokuwiki-xxxx-xx-xx/* /path/to/dokuwiki/

  cp 上的引号确保它将按原样运行，即使设置了别名。

• 检查复制的文件所有权和权限（有关详细信息，请参阅 权限）。
• 步骤5:删除所有未使用文件
• 步骤6：如有必要，升级您的模板和插件
• 步骤7：等待一天，让更新通知消失。或者，您可以按照更新检查中的步骤加快该过程

注意：是的，我们明确建议覆盖旧安装。如果你遵循仅在 *.local 文件中定义配置选项的建议（配置管理器会自动执行此操作），则以前的配置设置将不会被覆盖。所有页面和媒体文件也是如此。使用覆盖方法将为您节省很多保持页面修订正常工作的麻烦，因为这些修订取决于文件修改时间戳。

DokuWiki 版本自 2015-08-10 “Detritus”需要在 PHP插件suhosin 中（如果已安装）中进行一些特殊设置，否则编辑页面和插件更新/安装将不起作用。请参考 DokuWiki 安装的详细说明。

以下页面应提供有关常见升级后问题的提示：

• 如果看起来很奇怪或出现错误消息 – 则清除缓存
• 如果更新通知仍然存在 – 请尝试检查更新
• 工具栏 – 快速按钮和 JavaScript 问题
• 搜索索引 – 如果搜索框没有结果

如果您收到有关丢失/不可写目录的错误，您可能没有足够仔细地阅读 更新日志。升级到 Angua(我并没有找到和这个单词匹配的翻译) 时，您需要创建两个新目录并使它们可写：

• data/media_attic
• data/media_meta

以下是用户提供的几种不同的升级说明。它们可能略微过时。

• 使用 升级插件
• Upgrading by creating diffs
• Upgrading using Installatron Applications Installer
• Upgrading by APS
• Upgrading using common Linux commands (copy-paste commands)
• Installing and upgrading via git

从已有几年或更长时间的发行版升级时，最好使用上述步骤分阶段升级，一次一年。 您可以从这里下载升级包.