====== DokuWiki - Upgrade DokuWiki ======

===== Make a backup of your DokuWiki =====

<code bash>
tar zcpfv dokuwiki-backup.tar.gz /path/to/dokuwiki
</code>

<WRAP info>
**NOTE:**  This will create the **dokuwiki-backup.tar.gz** backup.

Alternatively, create a copy of the DokuWiki directory:  <code bash>
cd /var/www
cp -R dokuwiki dokuwiki-20250429
</code>

</WRAP>


----

===== Check for changes =====

Read the [[https://www.dokuwiki.org/changes|changelog]] to see if there are any special things to consider

----

===== Download the new version =====

Download the newest release from the download site.

<code bash>
cd ~
wget http://.../dokuwiki-xxxx-xx-xx.tgz
</code>

<WRAP info>
**NOTE:** The latest stable version can usually be downloaded.

<code bash>
cd ~
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
</code>

Sometimes the stable version may be corrupt and does not extract okay.  

  * In this case try to download a specified version.
  * Visit https://download.dokuwiki.org/archive
  * And then get the actual version needed:  <code bash>
wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-2024-02-06b.tgz
</code>


</WRAP>


----

===== Unpack the distribution tarball =====

<code bash>
tar zxvf dokuwiki-xxxx-xx-xx.tgz
</code>

----

===== Upload/copy the files over your previous installation =====

Make sure to overwrite all files when prompted.

<code bash>
'cp' -af dokuwiki-xxxx-xx-xx/* /path/to/dokuwiki/
</code>
       
<WRAP info>
**NOTE:**  The quotes on **cp** assure that it will run as is, even if an alias is set.
</WRAP>

----

===== Set permissions for the updated files =====

<code bash>
cd /var/www
chown -R www-data:www-data dokuwiki
</code>

----

===== Re-enable security settings for Dokuwiki =====

Change directory to the Dokuwiki config directory.

<code bash>
cd /var/www/dokuwiki/conf
</code>

Edit the Dokuwiki config file, and set the **useacl** option to a 1.

<file bash /var/www/dokuwiki/conf/dokuwiki.php>
...

/* Authentication Settings */
$conf['useacl']      = 1;                //Use Access Control Lists to restrict access?

...
</file>

----

===== Restart NginX =====

<code bash>
systemctl restart nginx.service
</code>


----

===== Check copied files ownership and permissions =====

<code bash>
<?php
 
if(function_exists('posix_geteuid')){
  // use posix to get current uid and gid
  $uid   = posix_geteuid();
  $usr   = posix_getpwuid($uid);
  $user  = $usr['name'];
  $gid   = posix_getegid();
  $grp   = posix_getgrgid($gid);
  $group = $grp['name'];
}else{
  // try to create a file and read it's ids
  $tmp = tempnam ('/tmp', 'check');
  $uid = fileowner($tmp);
  $gid = filegroup($tmp);
 
  // try to run ls on it
  $out = `ls -l $tmp`;
  $lst = explode(' ',$out);
  $user  = $lst[2];
  $group = $lst[3];
  unlink($tmp);
}
 
echo "Your PHP process seems to run with the UID $uid ($user) and the GID $gid ($group)\n"; ?>
</code>


Here are the most commonly used values for setting permissions on directories and files.

^directories^files^result^
|0700|0600|read/write for owner only. Owner must be the same as the PHP process user.|
|0770|0660|read/write for owner and group. The PHP process user needs to be in the user group|
|0777|0666|read/write for everyone. Dangerous because everybody with access to the server may write and delete your files. Use only as a last resort on trusted machines, NOT on a cheap shared hosting server.|


----

===== Delete all unused files =====

<code bash>
grep -Ev '^($|#)' data/deleted.files | xargs -n 1 rm -vf
</code>

----

===== Upgrade your template and plugins =====

Upgrade your template and plugins if necessary.


----

===== References =====

https://www.dokuwiki.org/install:upgrade

https://www.dokuwiki.org/install:unused_files