# DokuWiki for Ubuntu 24.04 Server
[![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 deploying the **latest stable release of DokuWiki** on Ubuntu 24.04 Server.

This is a **production-focused installer**, not a demo.

It assumes that Nginx and PHP-FPM are already installed and running.

---

## Related Installers

If you don’t have the required components, you can use this compatible installer:

- [Nginx + PHP-FPM Installer](https://git.x-files.dk/webserver/nginx-ubuntu)

---

### Download the Script
Clone the repository to your server:

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

```
cd dokuwiki-ubuntu
```

### Usage
Run the script and provide your desired domain name as an argument:

```
sudo ./dokuwikiinstall <domain name>
```

### Example
```
sudo ./dokuwikiinstall wiki.example.com
```

### Configuration
When the installation completes, visit:

```
http://<domain>/install.php
```

and complete the initial DokuWiki setup through the web interface.

---

### Post-install
After completing the web-based installation, run the post-install script to apply security and hardening settings:

```
sudo /tmp/dokuwiki-postinstall
```

---

### Nginx Integration

The generated DokuWiki configuration file listens on port 80.  
To enable HTTPS (port 443), use the example provided [here](https://git.x-files.dk/webserver/nginx-snippets/src/branch/main/hostfiles/dokuwiki.443.conf) 

> **NOTE**
> The file also includes optional caching directives (commented out by default).  
> You can enable them to improve load times and performance if needed.  
> The lines you are looking for are at the bottom of the generated config file and look like this:
> ```
> ##### Cache js css static content and open files start #####################
> # 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;
> ##### Cache js css static content and open files stop ######################
> ```

---

### Troubleshooting

**Nginx fails to restart**  
Run `nginx -t` and review any syntax errors reported in `/etc/nginx/conf.d/<domain>.conf`.

**PHP version mismatch**  
The script automatically detects your installed PHP version,  
but ensure that the PHP-FPM service (e.g., `php8.3-fpm`) is active.

---

### 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).

---