CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>install:upgrade [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="install,upgrade"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/install: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=install"/> <link rel="edit" title="Edit this page" href="/install:upgrade?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/install:upgrade"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/install:upgrade"/> <link rel="canonical" href="https://www.dokuwiki.org/install:upgrade"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <link rel="alternate" hreflang="de" href="https://www.dokuwiki.org/de:install:upgrade"/> <link rel="alternate" hreflang="es" href="https://www.dokuwiki.org/es:install:upgrade"/> <link rel="alternate" hreflang="fr" href="https://www.dokuwiki.org/fr:install:upgrade"/> <link rel="alternate" hreflang="it" href="https://www.dokuwiki.org/it:install:upgrade"/> <link rel="alternate" hreflang="ja" href="https://www.dokuwiki.org/ja:install:upgrade"/> <link rel="alternate" hreflang="ko" href="https://www.dokuwiki.org/ko:install:upgrade"/> <link rel="alternate" hreflang="pl" href="https://www.dokuwiki.org/pl:install:upgrade"/> <link rel="alternate" hreflang="pt-br" href="https://www.dokuwiki.org/pt-br:install:upgrade"/> <link rel="alternate" hreflang="ru" href="https://www.dokuwiki.org/ru:install:upgrade"/> <link rel="alternate" hreflang="zh" href="https://www.dokuwiki.org/zh:install:upgrade"/> <link rel="alternate" hreflang="zh-tw" href="https://www.dokuwiki.org/zh-tw:install:upgrade"/> <link rel="alternate" hreflang="x-default" href="https://www.dokuwiki.org/install:upgrade"/> <script >var NS='install';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"install:upgrade","namespace":"install","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="/install: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="install: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="install: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="/install:upgrade?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/install:upgrade?do=media&ns=install" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/install: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="/install:upgrade" class="breadcrumbs" title="install: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"> <div class="plugin_translation is-dropdown"><span class="title">Translations of this page<sup><a href="/localization" class="wikilink1" title="localization" data-wiki-id="localization">?</a></sup>: </span><ul><li class="span"><span class="wikilink1" title="English">English (en)</span></li><li class="a"><a class="wikilink2" title="|العربية" href="/ar:install:upgrade">|العربية (ar)</a></li><li class="a"><a class="wikilink2" title="Català" href="/ca:install:upgrade">Català (ca)</a></li><li class="a"><a class="wikilink2" title="Česky" href="/cs:install:upgrade">Česky (cs)</a></li><li class="a"><a class="wikilink2" title="Dansk" href="/da:install:upgrade">Dansk (da)</a></li><li class="a"><a class="wikilink1" title="Deutsch" href="/de:install:upgrade">Deutsch (de)</a></li><li class="a"><a class="wikilink2" title="Ελληνικά" href="/el:install:upgrade">Ελληνικά (el)</a></li><li class="a"><a class="wikilink2" title="Esperanto" href="/eo:install:upgrade">Esperanto (eo)</a></li><li class="a"><a class="wikilink1" title="Español" href="/es:install:upgrade">Español (es)</a></li><li class="a"><a class="wikilink2" title="فارسی" href="/fa:install:upgrade">فارسی (fa)</a></li><li class="a"><a class="wikilink1" title="Français" href="/fr:install:upgrade">Français (fr)</a></li><li class="a"><a class="wikilink2" title="עברית" href="/he:install:upgrade">עברית (he)</a></li><li class="a"><a class="wikilink2" title="Magyar" href="/hu:install:upgrade">Magyar (hu)</a></li><li class="a"><a class="wikilink1" title="Italiano" href="/it:install:upgrade">Italiano (it)</a></li><li class="a"><a class="wikilink1" title="日本語" href="/ja:install:upgrade">日本語 (ja)</a></li><li class="a"><a class="wikilink1" title="한국어" href="/ko:install:upgrade">한국어 (ko)</a></li><li class="a"><a class="wikilink2" title="Lietuvių Kalba" href="/lt:install:upgrade">Lietuvių Kalba (lt)</a></li><li class="a"><a class="wikilink2" title="Nederlands" href="/nl:install:upgrade">Nederlands (nl)</a></li><li class="a"><a class="wikilink2" title="Norsk" href="/no:install:upgrade">Norsk (no)</a></li><li class="a"><a class="wikilink1" title="Polski" href="/pl:install:upgrade">Polski (pl)</a></li><li class="a"><a class="wikilink1" title="Português" href="/pt-br:install:upgrade">Português (pt-br)</a></li><li class="a"><a class="wikilink2" title="Română" href="/ro:install:upgrade">Română (ro)</a></li><li class="a"><a class="wikilink1" title="Русский" href="/ru:install:upgrade">Русский (ru)</a></li><li class="a"><a class="wikilink2" title="Српски Језик" href="/sr:install:upgrade">Српски Језик (sr)</a></li><li class="a"><a class="wikilink2" title="Svenska" href="/sv:install:upgrade">Svenska (sv)</a></li><li class="a"><a class="wikilink2" title="ไทย" href="/th:install:upgrade">ไทย (th)</a></li><li class="a"><a class="wikilink2" title="Українська" href="/uk:install:upgrade">Українська (uk)</a></li><li class="a"><a class="wikilink1" title="中文" href="/zh:install:upgrade">中文 (zh)</a></li><li class="a"><a class="wikilink1" title="繁體中文" href="/zh-tw:install:upgrade">繁體中文 (zh-tw)</a></li></ul></div> <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>install: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="#upgrading_dokuwiki">Upgrading DokuWiki</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#troubleshooting">Troubleshooting</a></div></li> <li class="level2"><div class="li"><a href="#alternative_ways">Alternative Ways</a></div></li> <li class="level2"><div class="li"><a href="#upgrading_an_old_distribution">Upgrading an Old Distribution</a></div></li> </ul></li> </ul> </div> </div>  <h1 class="sectionedit1" id="upgrading_dokuwiki">Upgrading DokuWiki</h1> <div class="level1"> <p> Note: if you installed DokuWiki through your Linux Distribution's package manager (eg. using a <a href="/install:debian" class="wikilink1" title="install:debian" data-wiki-id="install:debian">Debian</a> or <a href="/install:fedora" class="wikilink1" title="install:fedora" data-wiki-id="install:fedora">Fedora</a> package) or similar tools you should also use the same package manager to upgrade your DokuWiki. Descriptions on this page are meant for standard, manual installations as described on the <a href="/install" class="wikilink1" title="install" data-wiki-id="install">install</a> page only. </p> <p> DokuWiki is very simple to upgrade. Its file layout is organized in a way that avoids overwriting any user content, which means an upgrade generally is just unpacking a new version on top of an old one. You should first try the simple instructions given here, if you encounter problems or the instructions are not detailed enough for you, read the details in the section below. Mac users should use Terminal; copying files via Finder will delete all data. </p> <ul> <li class="level1"><div class="li"> <strong>Step 0:</strong> Make sure your server meets the <a href="/requirements" class="wikilink1" title="requirements" data-wiki-id="requirements">requirements</a>.</div> </li> </ul> <ul> <li class="level1 node"><div class="li"> <strong>Step 1:</strong> Make a <a href="/faq:backup" class="wikilink1" title="faq:backup" data-wiki-id="faq:backup">backup</a> of your DokuWiki, this is not necessarily needed but recommended</div> <ul> <li class="level2"><div class="li"> Example:<br/> <pre class="code bash"><span class="kw2">tar</span> zcpfv dokuwiki-backup.tar.gz <span class="sy0">/</span>path<span class="sy0">/</span>to<span class="sy0">/</span>dokuwiki</pre> </div> </li> </ul> </li> </ul> <ul> <li class="level1"><div class="li"> <strong>Step 2:</strong> Read the <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">changelog</a> to see if there are any special things to consider</div> </li> </ul> <ul> <li class="level1 node"><div class="li"> <strong>Step 3:</strong> Download the newest release from the <a href="https://download.dokuwiki.org" class="urlextern" title="https://download.dokuwiki.org">download site</a>.</div> <ul> <li class="level2"><div class="li"> <pre class="code bash"><span class="kw3">cd</span> ~ <span class="kw2">wget</span> http:<span class="sy0">//</span>...<span class="sy0">/</span>dokuwiki-xxxx-xx-xx.tgz</pre> </div> </li> </ul> </li> </ul> <ul> <li class="level1 node"><div class="li"> <strong>Step 4:</strong> <a href="/install:unpacking" class="wikilink1" title="install:unpacking" data-wiki-id="install:unpacking">Unpack</a> the distribution tarball and upload/copy the files over your previous installation. Make sure to <strong>overwrite all files</strong> when prompted.</div> <ul> <li class="level2"><div class="li"> <pre class="code bash"><span class="kw2">tar</span> zxvf dokuwiki-xxxx-xx-xx.tgz <span class="st_h">'cp'</span> <span class="re5">-af</span> dokuwiki-xxxx-xx-xx<span class="sy0">/*</span> <span class="sy0">/</span>path<span class="sy0">/</span>to<span class="sy0">/</span>dokuwiki<span class="sy0">/</span></pre> <p> The quotes on cp assure that it will run as is, even if an alias is set. </p> </div> </li> <li class="level2"><div class="li"> Check copied files ownership and permissions (for details see <a href="/install:permissions" class="wikilink1" title="install:permissions" data-wiki-id="install:permissions">permissions</a>).</div> </li> </ul> </li> </ul> <ul> <li class="level1"><div class="li"> <strong>Step 5:</strong> Delete all <a href="/install:unused_files" class="wikilink1" title="install:unused_files" data-wiki-id="install:unused_files">unused files</a></div> </li> </ul> <ul> <li class="level1"><div class="li"> <strong>Step 6:</strong> Upgrade your <a href="/template" class="wikilink1" title="template" data-wiki-id="template">template</a> and <a href="/plugins" class="wikilink1" title="plugins" data-wiki-id="plugins">plugins</a> if necessary</div> </li> </ul> <ul> <li class="level1"><div class="li"> <strong>Step 7:</strong> Wait a day for the update notifications to go away. Alternatively, you can speed up the process by following the steps in <a href="/update_check" class="wikilink1" title="update_check" data-wiki-id="update_check">Update Check</a></div> </li> </ul> <p> Note: Yes, we explicitly recommend overwriting your old installation. If you adhered to the advice of defining config options in *.local files only (the Configuration Manager does this automatically) your previous config settings will <strong>not</strong> be overwritten. The same is true for all your pages and media files. Using the overwrite approach will save you a lot of trouble with keeping page revisions correctly working as these are depending on file modification time-stamps. </p> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/install:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730812985" /><input type="hidden" name="summary" value="[Upgrading DokuWiki] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="upgrading_dokuwiki" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-2585" /><button type="submit" title="Upgrading DokuWiki">Edit</button></div></form></div> <h2 class="sectionedit2" id="troubleshooting">Troubleshooting</h2> <div class="level2"> <p> The following pages should give you hints on common post-upgrade problems: </p> <ul> <li class="level1"><div class="li"> <a href="/caching" class="wikilink1" title="caching" data-wiki-id="caching">caching</a> – purge the cache if things look strange or error messages appear</div> </li> <li class="level1"><div class="li"> <a href="/config:updatecheck" class="wikilink1" title="config:updatecheck" data-wiki-id="config:updatecheck">updatecheck</a> – if update notifications persist</div> </li> <li class="level1"><div class="li"> <a href="/faq:toolbar" class="wikilink1" title="faq:toolbar" data-wiki-id="faq:toolbar">toolbar</a> – Quickbuttons and JavaScript problems</div> </li> <li class="level1"><div class="li"> <a href="/faq:searchindex" class="wikilink1" title="faq:searchindex" data-wiki-id="faq:searchindex">searchindex</a> – if search box gives you no result</div> </li> </ul> <p> If you get errors about missing/non-writable directories, you probably didn't read the <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">changelog</a> carefully enough. When upgrading to Angua you need to create two new directories and make them writable: </p> <ul> <li class="level1"><div class="li"> <code>data/media_attic</code></div> </li> <li class="level1"><div class="li"> <code>data/media_meta</code></div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/install:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730812985" /><input type="hidden" name="summary" value="[Troubleshooting] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="troubleshooting" /><input type="hidden" name="codeblockOffset" value="3" /><input type="hidden" name="range" value="2586-3224" /><button type="submit" title="Troubleshooting">Edit</button></div></form></div> <h2 class="sectionedit3" id="alternative_ways">Alternative Ways</h2> <div class="level2"> <p> Here are a few different upgrade descriptions, provided by users. They might be slightly out of date. </p> <ul> <li class="level1"><div class="li"> Use <a href="/plugin:upgrade" class="wikilink1" title="plugin:upgrade" data-wiki-id="plugin:upgrade">Upgrade Plugin</a></div> </li> <li class="level1"><div class="li"> <a href="/install:diffupgrade" class="wikilink1" title="install:diffupgrade" data-wiki-id="install:diffupgrade">Upgrading by creating diffs</a></div> </li> <li class="level1"><div class="li"> <a href="http://installatron.com/dokuwiki" class="urlextern" title="http://installatron.com/dokuwiki">Upgrading using Installatron Applications Installer</a></div> </li> <li class="level1"><div class="li"> <a href="http://apscatalog.com/1/splitbrain.org/dokuwiki/" class="urlextern" title="http://apscatalog.com/1/splitbrain.org/dokuwiki/">Upgrading by APS</a></div> </li> <li class="level1"><div class="li"> <del><a href="http://home.komsys.org/~jocke/upgrade-dokuwiki.txt" class="urlextern" title="http://home.komsys.org/~jocke/upgrade-dokuwiki.txt">Upgrading using common Linux commands (copy-paste commands)</a></del> <img src="/lib/images/smileys/fixme.svg" class="icon smiley" alt="FIXME" /></div> </li> <li class="level1"><div class="li"> <a href="http://falstaff.agner.ch/2010/08/12/using-git-to-install-dokuwiki/" class="urlextern" title="http://falstaff.agner.ch/2010/08/12/using-git-to-install-dokuwiki/">Installing and upgrading via git</a></div> </li> <li class="level1"><div class="li"> <strong>New!</strong> Use the <a href="/update_helper" class="wikilink1" title="update_helper" data-wiki-id="update_helper">DokuWiki Update Helper Script</a> to automate the upgrade process.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/install:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730812985" /><input type="hidden" name="summary" value="[Alternative Ways] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="alternative_ways" /><input type="hidden" name="codeblockOffset" value="3" /><input type="hidden" name="range" value="3225-3964" /><button type="submit" title="Alternative Ways">Edit</button></div></form></div> <h2 class="sectionedit4" id="upgrading_an_old_distribution">Upgrading an Old Distribution</h2> <div class="level2"> <p> When upgrading from a distribution which is a few or more years old, it is best to upgrade in stages, one year at a time, using the steps described above. You can get old distributions from the <a href="https://download.dokuwiki.org/archive" class="urlextern" title="https://download.dokuwiki.org/archive">download archive</a>. </p> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/install:upgrade"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730812985" /><input type="hidden" name="summary" value="[Upgrading an Old Distribution] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="upgrading_an_old_distribution" /><input type="hidden" name="codeblockOffset" value="3" /><input type="hidden" name="range" value="3965-" /><button type="submit" title="Upgrading an Old Distribution">Edit</button></div></form></div>  </div> <div class="docInfo"><bdi>install/upgrade.txt</bdi> · Last modified: <time datetime="2024-11-05T14:23:05+0100">2024-11-05 14:23</time> by <bdi>saggi</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="/install: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="/install: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="/install: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=install%3Aupgrade&1742561961" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>