CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>plugin:upgrade [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="plugin,upgrade"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/plugin:upgrade?do=index" title="Sitemap"/> <link rel="manifest" href="/lib/exe/manifest.php"/> <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/feed.php"/> <link rel="alternate" type="application/rss+xml" title="Current namespace" href="/feed.php?mode=list&ns=plugin"/> <link rel="edit" title="Edit this page" href="/plugin:upgrade?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/plugin:upgrade"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/plugin:upgrade"/> <link rel="canonical" href="https://www.dokuwiki.org/plugin:upgrade"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <script >var NS='plugin';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"plugin:upgrade","namespace":"plugin","ACT":"show","useHeadingNavigation":0,"useHeadingContent":0};(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.4/jquery.min.js" defer="defer"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js" defer="defer"></script> <script src="/lib/exe/js.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e&lang=en" defer="defer"></script> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="shortcut icon" href="/lib/tpl/dokuwiki/images/favicon.ico" /> <link rel="apple-touch-icon" href="/lib/tpl/dokuwiki/images/apple-touch-icon.png" /> <meta name="verify-v1" content="OVxl3gsCv2MhZqh1cBQyl0JytWXSwXMjyvwc+4w3WtA=" /> <meta name="google-site-verification" content="YhTVK69hW94ZXUtc2zSLPxTkZKbZIn0zK67mz5WQB-E" />  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-83791-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-83791-1', { 'anonymize_ip': true }); </script> </head> <body> <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki showSidebar hasSidebar">  <header id="dokuwiki__header"><div class="pad group"> <div class="headings group"> <ul class="a11y skip"> <li><a href="#dokuwiki__content">skip to content</a></li> </ul> <h1 class="logo"><a href="/start" accesskey="h" title="Home [h]"><img src="/lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /><span>DokuWiki</span></a></h1> <p class="claim">It's better when it's simple</p> </div> <div class="tools group">  <div id="dokuwiki__usertools"> <h3 class="a11y">User Tools</h3> <ul> <li class="action login"><a href="/plugin:upgrade?do=login&sectok=" title="Log In" rel="nofollow"><span>Log In</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10 17.25V14H3v-4h7V6.75L15.25 12 10 17.25M8 2h9a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2v-4h2v4h9V4H8v4H6V4a2 2 0 0 1 2-2z"/></svg></a></li> </ul> </div>  <div id="dokuwiki__sitetools"> <h3 class="a11y">Site Tools</h3> <form action="/start" method="get" role="search" class="search doku_form" id="dw__search" accept-charset="utf-8"><input type="hidden" name="do" value="search" /><input type="hidden" name="id" value="plugin:upgrade" /><div class="no"><input name="q" type="text" class="edit" title="[F]" accesskey="f" placeholder="Search" autocomplete="on" id="qsearch__in" value="" /><button value="1" type="submit" title="Search">Search</button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> <div class="mobileTools"> <form action="/doku.php" method="get" accept-charset="utf-8"><div class="no"><input type="hidden" name="id" value="plugin:upgrade" /><select name="do" class="edit quickselect" title="Tools"><option value="">Tools</option><optgroup label="Page Tools"><option value="edit">Edit this page</option><option value="revisions">Old revisions</option><option value="backlink">Backlinks</option></optgroup><optgroup label="Site Tools"><option value="recent">Recent Changes</option><option value="media">Media Manager</option><option value="index">Sitemap</option></optgroup><optgroup label="User Tools"><option value="login">Log In</option></optgroup></select><button type="submit">></button></div></form> </div> <ul> <li class="action recent"><a href="/plugin:upgrade?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/plugin:upgrade?do=media&ns=plugin" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/plugin:upgrade?do=index" title="Sitemap [x]" rel="nofollow" accesskey="x">Sitemap</a></li> </ul> </div> </div>  <div class="breadcrumbs"> <div class="trace"><span class="bchead">Trace:</span> <span class="bcsep">•</span> <span class="curid"><bdi><a href="/plugin:upgrade" class="breadcrumbs" title="plugin:upgrade">upgrade</a></bdi></span></div> </div> <hr class="a11y" /> </div></header> <div class="wrapper group">  <nav id="dokuwiki__aside" aria-label="Sidebar"><div class="pad aside include group"> <h3 class="toggle">Sidebar</h3> <div class="content"><div class="group"> <p> <strong>Learn about DokuWiki</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/features" class="wikilink1" title="features" data-wiki-id="features">Features</a> & <a href="/blogroll" class="wikilink1" title="blogroll" data-wiki-id="blogroll">reviews</a> </div> </li> <li class="level1"><div class="li"> <a href="/install" class="wikilink1" title="install" data-wiki-id="install">Installation guide</a></div> </li> <li class="level1"><div class="li"> <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">User manual</a> & <a href="/wiki:syntax" class="wikilink1" title="wiki:syntax" data-wiki-id="wiki:syntax">syntax</a></div> </li> <li class="level1"><div class="li"> <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">Release notes</a></div> </li> <li class="level1"><div class="li"> <a href="/faq" class="wikilink1" title="faq" data-wiki-id="faq">FAQ</a></div> </li> </ul> <p> <strong>Advanced Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/extensions" class="wikilink1" title="extensions" data-wiki-id="extensions">Extensions</a></div> </li> <li class="level1"><div class="li"> <a href="/development" class="wikilink1" title="development" data-wiki-id="development">Development manual</a></div> </li> </ul> <p> <strong>Corporate Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/faq:support" class="wikilink1" title="faq:support" data-wiki-id="faq:support">Get support</a></div> </li> <li class="level1"><div class="li"> <a href="/donate" class="wikilink1" title="donate" data-wiki-id="donate">Donations</a></div> </li> </ul> <p> <strong>Our Community</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/teams:getting_involved" class="wikilink1" title="teams:getting_involved" data-wiki-id="teams:getting_involved">Get involved</a></div> </li> <li class="level1"><div class="li"> <a href="/dokuinstall" class="wikilink1" title="dokuinstall" data-wiki-id="dokuinstall">Users</a></div> </li> <li class="level1"><div class="li"> <a href="http://forum.dokuwiki.org" class="urlextern" title="http://forum.dokuwiki.org">User forum</a></div> </li> <li class="level1"><div class="li"> <a href="/mailinglist" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">Development mailinglist</a></div> </li> </ul> <hr /> <p> Follow us on <a href="https://phpc.social/@dokuwiki" class="urlextern" title="https://phpc.social/@dokuwiki">Mastodon</a> and other <a href="/social" class="wikilink1" title="social" data-wiki-id="social">social networks</a>. </p> <p> <a href="/privacy" class="wikilink1" title="privacy" data-wiki-id="privacy">Our Privacy Policy</a> </p> </div></div> </div></nav>  <main id="dokuwiki__content"><div class="pad group"> <div class="pageId"><span>plugin:upgrade</span></div> <div class="page group">   <div id="dw__toc" class="dw__toc"> <h3 class="toggle">Table of Contents</h3> <div> <ul class="toc"> <li class="level1"><div class="li"><a href="#upgrade_plugin">upgrade Plugin</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#download_and_installation">Download and Installation</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#changes">Changes</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#usage">Usage</a></div></li> <li class="level2"><div class="li"><a href="#command_line">Command Line</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#usage1">Usage</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#q_a">Q & A</a></div></li> </ul></li> </ul> </div> </div>  <h1 class="sectionedit1" id="upgrade_plugin">upgrade Plugin</h1> <div class="level1"> <div class="pluginrepo_entry"><div class="usageInfo"><div class="compatibility"><p class="label">Compatible with DokuWiki</p><div class="versions"><ul><li class="yes">2024-02-06 "Kaos" <strong><span>yes</span></strong></li><li class="yes">2023-04-04 "Jack Jackrum" <strong><span>yes</span></strong></li><li class="yes">2022-07-31 "Igor" <strong><span>yes</span></strong></li><li class="yes">2020-07-29 "Hogfather" <strong><span>yes</span></strong></li></ul></div></div><ul class="actions"><li><a class="download" href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/zipball/master">Download</a></li><li><a class="bugs" href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/issues">Report bugs</a></li><li><a class="donate" href="https://donate.dokuwiki.org/upgrade">Donate</a></li></ul><div class="clearer"></div></div><div class="mainInfo"><p class="description"><a class="media" href="/plugins"><img alt="plugin" class="medialeft" src="/lib/plugins/pluginrepo/images/dwplugin.png" width="60" height="60" /></a> Update your DokuWiki with a few clicks from the admin interface</p><a href="/_media/plugin:upgrade.png" class="media screenshot" title="Screenshot of upgrade" rel="lightbox" data-url="/_media/plugin:upgrade.png"><img src="/_media/plugin:upgrade.png?w=220&tok=571e21" alt="" width="220" /></a></div><div class="metaInfo"><dl><dt>Last updated on</dt><dd>2024-02-06</dd><dt>Provides</dt><dd><a href="/plugins?plugintype=16#extension__table" class="wikilink1" title="List all Helper plugins">Helper</a>, <a href="/plugins?plugintype=2#extension__table" class="wikilink1" title="List all Admin plugins">Admin</a>, <a href="/plugins?plugintype=256#extension__table" class="wikilink1" title="List all CLI plugins">CLI</a></dd><dt>Repository</dt><dd><a class="urlextern" href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/">Source</a></dd></dl></div><div class="moreInfo"><p class="similar">Similar to <a href="/plugin:elwikiupgrade" class="wikilink1" title="plugin:elwikiupgrade" data-wiki-id="plugin:elwikiupgrade">elwikiupgrade</a></p><p class="tags">Tagged with <a href="/plugins?plugintag=update#extension__table" class="wikilink1" title="List all plugins with this tag">update</a>, <a href="/plugins?plugintag=upgrade#extension__table" class="wikilink1" title="List all plugins with this tag">upgrade</a></p></div><div class="authorInfo"><strong>By <a href="mailto:andi%20%5Bat%5D%20splitbrain%20%5Bdot%5D%20org" class="mail" title="andi [at] splitbrain [dot] org">Andreas Gohr</a></strong><ul><li><a href="/plugin:badbehaviour" class="wikilink1" title="plugin:badbehaviour" data-wiki-id="plugin:badbehaviour">badbehaviour</a></li> <li><a href="/plugin:amazon" class="wikilink1" title="plugin:amazon" data-wiki-id="plugin:amazon">amazon</a></li> <li><a href="/plugin:xfortune" class="wikilink1" title="plugin:xfortune" data-wiki-id="plugin:xfortune">xfortune</a></li> <li><a href="/plugin:statistics" class="wikilink1" title="plugin:statistics" data-wiki-id="plugin:statistics">statistics</a></li> <li><a href="/plugin:translation" class="wikilink1" title="plugin:translation" data-wiki-id="plugin:translation">translation</a></li> <li><a href="/plugin:captcha" class="wikilink1" title="plugin:captcha" data-wiki-id="plugin:captcha">captcha</a></li> <li><a href="/plugin:graphviz" class="wikilink1" title="plugin:graphviz" data-wiki-id="plugin:graphviz">graphviz</a></li> <li><a href="/plugin:acl" class="wikilink1" title="plugin:acl" data-wiki-id="plugin:acl">acl</a></li> <li><a href="/plugin:info" class="wikilink1" title="plugin:info" data-wiki-id="plugin:info">info</a></li> <li><a href="/plugin:ditaa" class="wikilink1" title="plugin:ditaa" data-wiki-id="plugin:ditaa">ditaa</a></li> <li>and 60 more</li></ul></div></div> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[upgrade Plugin] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="upgrade_plugin" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-767" /><button type="submit" title="upgrade Plugin">Edit</button></div></form></div> <h2 class="sectionedit2" id="download_and_installation">Download and Installation</h2> <div class="level2"> <p> Search and install the plugin using the <a href="/plugin:extension" class="wikilink1" title="plugin:extension" data-wiki-id="plugin:extension">Extension Manager</a>. Refer to <a href="/plugins" class="wikilink1" title="plugins" data-wiki-id="plugins">Plugins</a> on how to install plugins manually. </p> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Download and Installation] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="download_and_installation" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="768-945" /><button type="submit" title="Download and Installation">Edit</button></div></form></div> <h3 class="sectionedit3" id="changes">Changes</h3> <div class="level3"> <ul class="rss"><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/1fb17b9f85113dacd48e8a0a50212e3c3a131064" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/1fb17b9f85113dacd48e8a0a50212e3c3a131064">Merge pull request #255 from dokuwiki-translate/lang_update_977_17303…</a> (2024-11-08 09:15)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/29510020e50391ccf60a1f17f6d8fb2c950d362c" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/29510020e50391ccf60a1f17f6d8fb2c950d362c">translation update</a> (2024-10-31 12:05)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/20c3ebdfa22db13f0e1c552a6357de22ded6f5b4" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/20c3ebdfa22db13f0e1c552a6357de22ded6f5b4">Merge pull request #254 from dokuwiki-translate/lang_update_968_17290…</a> (2024-10-30 09:22)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/492a7e0c228ec3de4a0488a2c58470320f039fcb" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/492a7e0c228ec3de4a0488a2c58470320f039fcb">translation update</a> (2024-10-16 08:10)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/dfc81f6b57c395dad1c5daaf5203226d44d9a0d2" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/dfc81f6b57c395dad1c5daaf5203226d44d9a0d2">Merge pull request #245 from dokuwiki-translate/lang_update_853_17157…</a> (2024-07-29 08:17)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/1dc319c1fe8b3c8d2d3eed575cb8226a91a9df01" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/1dc319c1fe8b3c8d2d3eed575cb8226a91a9df01">translation update</a> (2024-05-15 14:40)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/5838e156bd44c9b5acf654d060c83a34263438ed" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/5838e156bd44c9b5acf654d060c83a34263438ed">Version upped</a> (2024-02-06 23:50)</div></li><li><div class="li"><a href="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/8dab6045215dcba6d736537f8a021932d3980362" class="urlextern" title="https://github.com/splitbrain/dokuwiki-plugin-upgrade/commit/8dab6045215dcba6d736537f8a021932d3980362">some code style cleanups</a> (2024-02-06 11:31)</div></li></ul> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Changes] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="changes" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="946-1052" /><button type="submit" title="Changes">Edit</button></div></form></div> <h2 class="sectionedit4" id="usage">Usage</h2> <div class="level2"> <p> This plugin adds a new option to your admin interface called “Wiki Upgrade”. Follow the wizard and upgrade your wiki to the most current stable release of DokuWiki in just a few steps. </p> <p> Note: this plugin needs write access to all your DokuWiki files, not only files inside data. If you installed DokuWiki through the <a href="/install:downloader" class="wikilink1" title="install:downloader" data-wiki-id="install:downloader">DokuWiki Downloader</a>, permissions should be fine already. Don't worry though, the plugin will check for needed permissions before doing the real upgrade process. </p> <p> <img src="/lib/images/smileys/exclaim.svg" class="icon smiley" alt=":!:" /> Creating a backup (see <a href="/faq:backup" class="wikilink1" title="faq:backup" data-wiki-id="faq:backup">FAQ - Backup</a>) of your wiki before upgrading is highly recommended. It's NOT done by the plugin. <img src="/lib/images/smileys/exclaim.svg" class="icon smiley" alt=":!:" /> </p> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Usage] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="usage" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1053-1716" /><button type="submit" title="Usage">Edit</button></div></form></div> <h2 class="sectionedit5" id="command_line">Command Line</h2> <div class="level2"> <p> The plugin can also be used from the command line. There are two ways to do so: </p> <ol> <li class="level1"><div class="li"> Modern wikis (post-Greebo) support command line plugins which can be called through the <code>bin/plugin.php</code> script. This is the preferred method of using the upgrade plugin. This ensures a properly initialized DokuWiki environment when upgrading.</div> </li> <li class="level1"><div class="li"> Older wikis (tested back to a release from 2006) can be upgraded by calling <code>lib/plugins/upgrade/legacy.php</code>. This is particularly useful when the old wiki is no longer running with a modern PHP version. The legacy script does not load any existing (outdated) DokuWiki code, but will make more assumptions on your setup. Read the comments at the top of the script for more info.</div> </li> </ol> <p> Below both methods are shown. Prefer the first when possible. </p> </div> <div class="secedit editbutton_section editbutton_5"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Command Line] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="command_line" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1717-2522" /><button type="submit" title="Command Line">Edit</button></div></form></div> <h3 class="sectionedit6" id="usage1">Usage</h3> <div class="level3"> <p> To check permissions and versions, without actually updating run: </p> <ol> <li class="level1"><div class="li"> <code>php bin/plugin.php upgrade check</code></div> </li> <li class="level1"><div class="li"> <code>php lib/plugins/upgrade/legacy.php check</code></div> </li> </ol> <p> To run the upgrade: </p> <ol> <li class="level1"><div class="li"> <code>php bin/plugin.php upgrade run</code></div> </li> <li class="level1"><div class="li"> <code>php lib/plugins/upgrade/legacy.php run</code></div> </li> </ol> <p> Check the help screen for any addtional options: </p> <ol> <li class="level1"><div class="li"> <code>php bin/plugin.php upgrade -h</code></div> </li> <li class="level1"><div class="li"> <code>php lib/plugins/upgrade/legacy.php -h</code></div> </li> </ol> </div> <div class="secedit editbutton_section editbutton_6"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Usage] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="usage1" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2523-2942" /><button type="submit" title="Usage">Edit</button></div></form></div> <h2 class="sectionedit7" id="q_a">Q & A</h2> <div class="level2"> </div> <h4 id="usable_on_systems_without_internet_access">Usable on systems without internet access?</h4> <div class="level4"> <p> The plugin downloads new releases directly from the github.com repository. Therefore it needs direct access to the internet. </p> </div> <h4 id="any_php_requirements">Any PHP requirements?</h4> <div class="level4"> <p> Make sure that PHP was compiled with <a href="http://www.php.net/manual/en/openssl.installation.php" class="urlextern" title="http://www.php.net/manual/en/openssl.installation.php">php_openssl</a> enabled. Your PHP version will also need to be new enough for the new DokuWiki version to be installed (the plugin will check that for you). </p> </div> <h4 id="i_moved_some_folders_out_of_the_webroot_is_that_a_problem">I moved some folders out of the Webroot, is that a problem?</h4> <div class="level4"> <p> The upgrade plugin does currently not support installations where the <code>conf</code> directory was moved from the default location. </p> <p> If you moved the <code>data</code> directory, the plugin will recreate a <code>data</code> directory at the default location. That directory can be safely deleted afterwards. You may need to create any new subfolder inside <em>your</em> <code>data</code> directory manually after the upgrade. </p> </div> <h4 id="upgrade_to_weatherwax">Upgrade to Weatherwax</h4> <div class="level4"> <p> Upgrade to Weatherwax using this plugin is only recommended when you're using the plain auth mechanism. Other authbackends probably need some manual config tuning. </p> </div> <h4 id="languages">Languages</h4> <div class="level4"> <p> The plugin will install the new version with <strong>all</strong> languages included. Even if you originally downloaded DokuWiki with a limited set of languages. You can use the <a href="/plugin:langdelete" class="wikilink1" title="plugin:langdelete" data-wiki-id="plugin:langdelete">langdelete</a> plugin to clean up afterwards. </p> </div> <div class="secedit editbutton_section editbutton_7"><form class="button btn_secedit" method="post" action="/plugin:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1719511712" /><input type="hidden" name="summary" value="[Q & A] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="q_a" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2943-" /><button type="submit" title="Q & A">Edit</button></div></form></div>  </div> <div class="docInfo"><bdi>plugin/upgrade.txt</bdi> · Last modified: <time datetime="2024-06-27T20:08:32+0200">2024-06-27 20:08</time> by <bdi>66.79.248.60</bdi></div> <hr class="a11y" /> </div></main>  <nav id="dokuwiki__pagetools" aria-labelledby="dokuwiki__pagetools__heading"> <h3 class="a11y" id="dokuwiki__pagetools__heading">Page Tools</h3> <div class="tools"> <ul> <li class="edit"><a href="/plugin:upgrade?do=edit" title="Edit this page [e]" rel="nofollow" accesskey="e"><span>Edit this page</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg></a></li><li class="revs"><a href="/plugin:upgrade?do=revisions" title="Old revisions [o]" rel="nofollow" accesskey="o"><span>Old revisions</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M11 7v5.11l4.71 2.79.79-1.28-4-2.37V7m0-5C8.97 2 5.91 3.92 4.27 6.77L2 4.5V11h6.5L5.75 8.25C6.96 5.73 9.5 4 12.5 4a7.5 7.5 0 0 1 7.5 7.5 7.5 7.5 0 0 1-7.5 7.5c-3.27 0-6.03-2.09-7.06-5h-2.1c1.1 4.03 4.77 7 9.16 7 5.24 0 9.5-4.25 9.5-9.5A9.5 9.5 0 0 0 12.5 2z"/></svg></a></li><li class="backlink"><a href="/plugin:upgrade?do=backlink" title="Backlinks" rel="nofollow"><span>Backlinks</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10.59 13.41c.41.39.41 1.03 0 1.42-.39.39-1.03.39-1.42 0a5.003 5.003 0 0 1 0-7.07l3.54-3.54a5.003 5.003 0 0 1 7.07 0 5.003 5.003 0 0 1 0 7.07l-1.49 1.49c.01-.82-.12-1.64-.4-2.42l.47-.48a2.982 2.982 0 0 0 0-4.24 2.982 2.982 0 0 0-4.24 0l-3.53 3.53a2.982 2.982 0 0 0 0 4.24m2.82-4.24c.39-.39 1.03-.39 1.42 0a5.003 5.003 0 0 1 0 7.07l-3.54 3.54a5.003 5.003 0 0 1-7.07 0 5.003 5.003 0 0 1 0-7.07l1.49-1.49c-.01.82.12 1.64.4 2.43l-.47.47a2.982 2.982 0 0 0 0 4.24 2.982 2.982 0 0 0 4.24 0l3.53-3.53a2.982 2.982 0 0 0 0-4.24.973.973 0 0 1 0-1.42z"/></svg></a></li><li class="top"><a href="#dokuwiki__top" title="Back to top [t]" rel="nofollow" accesskey="t"><span>Back to top</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"/></svg></a></li> </ul> </div> </nav> </div>  <footer id="dokuwiki__footer"><div class="pad"> <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license" class="urlextern">CC Attribution-Share Alike 4.0 International</a></bdi></div> <div class="buttons"> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license"><img src="/lib/images/license/button/cc-by-sa.png" alt="CC Attribution-Share Alike 4.0 International" /></a> <a href="https://www.dokuwiki.org/donate" title="Donate" ><img src="/lib/tpl/dokuwiki/images/button-donate.gif" width="80" height="15" alt="Donate" /></a> <a href="https://php.net" title="Powered by PHP" ><img src="/lib/tpl/dokuwiki/images/button-php.gif" width="80" height="15" alt="Powered by PHP" /></a> <a href="//validator.w3.org/check/referer" title="Valid HTML5" ><img src="/lib/tpl/dokuwiki/images/button-html5.png" width="80" height="15" alt="Valid HTML5" /></a> <a href="//jigsaw.w3.org/css-validator/check/referer?profile=css3" title="Valid CSS" ><img src="/lib/tpl/dokuwiki/images/button-css.png" width="80" height="15" alt="Valid CSS" /></a> <a href="https://dokuwiki.org/" title="Driven by DokuWiki" ><img src="/lib/tpl/dokuwiki/images/button-dw.png" width="80" height="15" alt="Driven by DokuWiki" /></a> </div> <div style="margin-top: 2em; font-size:90%" class="dokuwiki"><div style="float:right"><a href="http://www.splitbrain.org/personal#imprint" style="float:right; text-decoration: none; color:#333">Imprint</a></div></div> <style type="text/css"> @media screen { body { padding-top: 30px; } #global__header { position: absolute; top: 0; left: 0; text-align: left; vertical-align: middle; line-height: 1.5; background-color: #333; box-shadow: 0 0 8px rgba(0,0,0,0.5); width: 100%; margin: 0; padding: 5px 20px; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; white-space: nowrap; overflow: hidden; } #global__header h2 { position: absolute; left: -99999em; top: 0; overflow: hidden; display: inline; } #global__header ul, #global__header li { margin: 0; padding: 0; list-style: none; display: inline; line-height: 1.5; } #global__header a { color: #bbb; text-decoration: none; margin-right: 20px; font-size: 14px; font-weight: normal; } #global__header a:hover, #global__header a:active, #global__header a:focus { color: #fff; text-decoration: underline; } #global__header form { float: right; margin: 0 0 0 20px; } #global__header input { background-color: #333; background-image: none; border: 1px solid #bbb; color: #fff; box-shadow: none; border-radius: 2px; margin: 0; line-height: normal; padding: 1px 0 1px 0; height: auto; } #global__header input.button { border: none; color: #bbb; } #global__header input.button:hover, #global__header input.button:active, #global__header input.button:focus { color: #fff; text-decoration: underline; } } /* /@media */ @media only screen and (min-width: 601px) { /* changes specific for www.dokuwiki.org */ #dokuwiki__header { padding-top: 3em; } #dokuwiki__usertools { top: 3em; } /* changes specific for bugs.dokuwiki.org */ div#container div#showtask { top: 40px; } } /* /@media */ @media only screen and (max-width: 600px) { body { padding-top: 0; } #global__header { position: static; white-space: normal; overflow: auto; } #global__header form { float: none; display: block; margin: 0 0 .4em; } } /* /@media */ @media print { #global__header { display: none; } } /* /@media */ </style> <div id="global__header"> <h2>Global DokuWiki Links</h2> <form method="get" action="https://search.dokuwiki.org/" target="_top"> <input type="text" name="q" title="Search all DokuWiki sites at once" class="input" /> <input type="submit" title="Search all DokuWiki sites at once" value="Search" class="button" /> </form> <ul> <li><a href="https://download.dokuwiki.org" title="Download the latest release" target="_top">Download</a></li> <li><a href="https://www.dokuwiki.org" title="Read the DokuWiki documentation" target="_top">Wiki</a></li> <li><a href="https://forum.dokuwiki.org" title="Ask questions in the DokuWiki forum" target="_top">Forum</a></li> <li><a href="https://irc.dokuwiki.org" title="Check IRC chat logs or join the chat" target="_top">IRC</a></li> <li><a href="https://github.com/splitbrain/dokuwiki/issues" title="Report and track bugs" target="_top">Bugs</a></li> <li><a href="https://translate.dokuwiki.org/" title="Help translating the DokuWiki interface" target="_top">Translate</a></li> <li><a href="https://github.com/splitbrain/dokuwiki" title="Access the most recent git commits" target="_top">Git</a></li> <li><a href="https://xref.dokuwiki.org/reference/dokuwiki/" title="Cross-Reference of the DokuWiki source code" target="_top">XRef</a></li> <li><a href="https://codesearch.dokuwiki.org/" title="Search through the sources of DokuWiki, plugins and templates" target="_top">Code Search</a></li> </ul> </div>  </div></footer> </div></div> <div class="no"><img src="/lib/exe/taskrunner.php?id=plugin%3Aupgrade&1742867163" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>