DokuWiki on Ubuntu 24.04
Install DokuWiki on Ubuntu 24.04 server.
This is not a demo and not a quick experiment.
This is a production installer — designed for long-term use with hardened configs.
Why this installer exists
Many tutorials skip permissions, hardening, and caching considerations. This one does it correctly and securely.
What this installer does
✔ Creates isolated host + directory
✔ Applies correct permissions
✔ Removes installer files when done
✔ Supports HTTPS, caching and rate rules
What this installer does NOT do
It won’t stop you from running the script without reading the documentation like there’s no tomorrow.
Skip the README, and whatever happens next is your headache, not a bug report.
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.