You've already forked dokuwiki-ubuntu
108 lines
2.8 KiB
Markdown
108 lines
2.8 KiB
Markdown
# DokuWiki for Ubuntu 24.04 Server
|
||
[](#)
|
||
[](#)
|
||
[](#)
|
||
[](#)
|
||
[](#)
|
||
[](./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).
|
||
|
||
---
|