initial commit

2025-10-23 15:43:13 +02:00
commit 709dddd8e3
4 changed files with 277 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,107 @@
+# 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).
+
+---