Files
dokuwiki-ubuntu/README.md
2025-11-28 13:58:53 +01:00

2.3 KiB
Raw Blame History

DokuWiki on Ubuntu 24.04

OS Shell WebServer PHP App License

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

If not, start here:
https://git.x-files.dk/webserver/nginx-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. PostInstall Hardening

sudo /tmp/dokuwiki-postinstall

This script:

✔ Removes installer
✔ Secures permissions
✔ Applies sane defaults
✔ Makes the wiki productionsafe


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.