# DokuWiki on Ubuntu 24.04  
[![OS](https://img.shields.io/badge/ubuntu-24.04-E95420)](#)
[![Shell](https://img.shields.io/badge/shell-bash-121011)](#)
[![WebServer](https://img.shields.io/badge/server-nginx-009639)](#)
[![PHP](https://img.shields.io/badge/php-fpm-777BB4)](#)
[![App](https://img.shields.io/badge/app-dokuwiki-0098D4)](#)
[![License](https://img.shields.io/badge/License-MIT-green)](./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. 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](https://wiki.x-files.dk)

---

### License
Licensed under the [MIT License](./LICENSE).

---