dokuwiki-install/README.md

## Dokuwiki install script for Ubuntu 22.04 and 24.04 server.

### Prerequisites
Ubuntu 22.04 or higher with Nginx and Php-Fpm. Nginx with Php-Fpm can be installed from
[\[Here\]](https://git.x-files.dk/ubuntu-web-server/nginx-install)

**Important:**\
This the script will only work if you installed Nginx using the script located [\[Here\]](https://git.x-files.dk//ubuntu-web-server/nginx-install)

### Download the script
```
git clone https://git.x-files.dk/ubuntu-web-application/dokuwiki-install.git
```

### Usage
    cd dokuwiki-install
    sudo ./dokuwikiinstall <domain name>

### Example
    sudo ./dokuwikiinstall wiki.something.xyz

This will create a Dokuwiki site running on port 80 with the domain name you chose under the installation. 
Don't worry though this can easily be fixed by modifying the Nginx configuration later. 
If you need an example on how to configure Nginx to run this on port 443 I an example 
[\[Here\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg-apps/dokuwiki.443.conf)

### Configuration
Once the script is done browse to http://<i></i>wiki.hostname.xyz/install.php and fill out the mandatory fields marked with green.
<p align="center" width="100%">
<img src="https://git.x-files.dk/assets/dokuwiki-configuration.png" alt="Dokuwiki Configuration"/>
</p>

### Post install
This is needed in order to change some configuration settings in Nginx after you are done with the setup screen.

    cd dokuwiki-install
    sudo ./postinstall

### Troubleshooting
Most issues will probably be caused by the fact that we all set up and configure Nginx diffrently. If you encounter problems I would suggest you look at the Nginx configuration I use 
[\[Here\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg/nginx.conf)
and also the default "sites-enabled" Nginx configurarion I use 
[\[Here\]](https://git.x-files.dk/ubuntu-web-server/nginx-install/src/branch/main/cfg/default) 
when you start troubleshooting.

### More guides
More guides can be found on [\[wiki.x-files.dk\]](https://wiki.x-files.dk)

### Last tested
October 10th 2024 on Ubuntu 24.04.