===== Dokuwiki Docker =====
{{tag>Linux Docker Dokuwiki Ubuntu}}

==== Prerequisites ====
Prerequisites - Ubuntu
<code>
sudo apt update
sudo apt -y upgrade
sudo apt -y install docker.io docker-compose
sudo usermod -aG docker $USER
sudo reboot
mkdir dokuwiki
cd dokuwiki
mkdir config
</code>

==== Install ====
Create docker compose file
<code>
cd ~/dokuwiki
vim docker-compose.yaml
</code>
<file - docker-compose.yaml>
---
version: "2.1"
services:
  dokuwiki:
    image: lscr.io/linuxserver/dokuwiki:latest
    container_name: dokuwiki
    environment:
      - PUID=1001
      - PGID=1001
      - TZ=Etc/UTC
    volumes:
      - /home/ubuntu/dokuwiki/config:/config
    ports:
      - 8080:80
      - 8443:443 #optional
    restart: unless-stopped
</file>

Install Static Image
<code>
cd ~/dokuwiki
sudo docker-compose pull
sudo docker-compose up -d
</code>

Visit https://SITEADDRESS:8443/install.php

==== Backup and Restore ====
Copy the following from backup file
^Backup               ^New Container                          ^
|dokuwiki/data/media/ |~/dokuwiki/config/dokuwiki/data/media/ |
|dokuwiki/data/pages/ |~/dokuwiki/config/dokuwiki/data/pages/ |

Use the [[http://www.dokuwiki.org/plugin:searchindex|Searchindex Manager]] plugin to re-index pages.
==== Stop and Update ====
Stop
<code>
cd ~/dokuwiki
docker-compose down
</code>

Update Static Image
<code>
cd ~/dokuwiki
docker-compose down
docker-compose rm
docker-compose pull
docker-compose up --build -d
</code>

==== Miscellaneous ====
Allow use of SVG images
<code>
vim ~/dokuwiki/config/dokuwiki/conf/mime.local.conf
</code>
<file - mime.local.conf>
svg     image/svg+xml
</file>

If using the [[https://www.dokuwiki.org/plugin:tag|Tag]] plugin, install the [[http://www.dokuwiki.org/plugin:searchindex|Searchindex Manager]] plugin and use to re-index.

Enable nice URLs by using **Configuration Manager - Advanced** to set **Use Nice URLs** to ''.htaccess''.

Widen page by using **Template Style Settings** to set **The width of the full site (can be any length unit: %, px, em, ...)** to ''96em''

Update logo by replacing file located at ''wiki:dokuwiki-128.png'' then run
<code>
cp ~/dokuwiki/config/dokuwiki/data/media/wiki/dokuwiki-128.png ~/dokuwiki/config/dokuwiki/lib/tpl/dokuwiki/images/logo.png
</code>

Update favicon by uploading file to ''wiki:favicon.ico''

If running behind a load balancer configure logging by editing ''~/dokuwiki/config/nginx/nginx.conf'' and add/update the following.
<code>
http {
	##
	# Logging Settings
	##

	log_format combined_realip '$http_x_forwarded_for - $remote_user [$time_local] '
		'"$request" $status $body_bytes_sent '
		'"$http_referer" "$http_user_agent"';

	#access_log /config/log/nginx/access.log;
	access_log /config/log/nginx/access.log combined_realip;
}
</code>
----
  * https://hub.docker.com/r/linuxserver/dokuwiki
  * https://github.com/linuxserver/docker-dokuwiki
  * https://www.dokuwiki.org/plugin:svgembed#uploading_svg_files_via_media_manager
  * https://docs.nginx.com/nginx/admin-guide/monitoring/logging/