dokuwiki-ubuntu/README.md

DokuWiki on Ubuntu 24.04

Automated Bash installer for the latest stable DokuWiki on Ubuntu 24.04, configured for Nginx + PHP-FPM.

This deploys a production-ready wiki, not a classroom demo.
Clean config, isolated site directory, post-install hardening included.

---

Requirements

You must already have:

✔ Nginx installed
✔ PHP-FPM running

Optional Installers (if you need them — saves you some googling)

Install Nginx + PHP-FPM on Ubuntu

---

1. Download

git clone https://git.x-files.dk/webapps/dokuwiki-ubuntu.git

cd dokuwiki-ubuntu

---

2. Install

sudo ./dokuwikiinstall <domain>

Example:

sudo ./dokuwikiinstall wiki.example.com

Generated paths:

File/Dir	Purpose
/var/www/<domain>	DokuWiki installation
/etc/nginx/conf.d/<domain>.conf	Virtualhost
/tmp/dokuwiki-postinstall	Hardening script

---

3. Web Setup

Visit:

http://<domain>/install.php

Create admin + finish setup.

---

4. Post‑Install Hardening

sudo /tmp/dokuwiki-postinstall

This script:

✔ Removes installer
✔ Secures permissions
✔ Applies sane defaults
✔ Makes the wiki production‑safe

---

HTTPS

Enable TLS with:

https://git.x-files.dk/webserver/nginx-snippets/src/branch/main/hostfiles/dokuwiki.443.conf

Optional caching (disabled by default):

# include /etc/nginx/nginx-snippets/cache-open-files.conf;
# include /etc/nginx/nginx-snippets/cache-statics.conf;
# include /etc/nginx/nginx-snippets/cache-js-css.conf;

---

Troubleshooting

Issue	Cause	Fix
Nginx restart fails	Config syntax	nginx -t
PHP errors	Wrong FPM version	systemctl status php8.3-fpm
install.php still present	Postinstall not run	sudo /tmp/dokuwiki-postinstall

---

More Information

More guides and documentation can be found on wiki.x-files.dk

---

License

Licensed under the MIT License.

---