From d9e7867d1dbe53bc2761a92c9e52ae48155a8408 Mon Sep 17 00:00:00 2001
From: Rainer <rainer@geiger-its.de>
Date: Mon, 23 Jun 2025 17:52:26 +0200
Subject: [PATCH] =?UTF-8?q?Installation=20hinzugef=C3=BCgt?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Installation.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 69 insertions(+)
 create mode 100644 Installation.md

diff --git a/Installation.md b/Installation.md
new file mode 100644
index 0000000..bd4f5ed
--- /dev/null
+++ b/Installation.md
@@ -0,0 +1,69 @@
+# Installation & Initial Setup
+
+This guide will walk you through the process of setting up the Luanti-Web toolkit on a Debian-based Linux server (like Debian or Ubuntu).
+
+---
+
+### 1. Prerequisites
+
+Before downloading the project files, you need to ensure that all required software packages (dependencies) are installed on your system.
+
+Run the following commands to install all prerequisites using `apt-get`:
+
+```bash
+# Update your package list first
+sudo apt-get update
+
+# Install all required packages in one command
+sudo apt-get install -y imagemagick libvips-tools gdal-bin python3-gdal sqlite3 bc jq
+```
+
+**Manual Dependency:**
+* **minetestmapper:** This tool is not available in standard repositories. You must download a compatible executable for your system and place it inside the project's root directory (e.g., `/opt/luweb/minetestmapper`).
+
+After completing all setup steps, you can verify your installation by running the included dependency checker script.
+
+### 2. Download Project Files
+
+You have two options to get the project files:
+
+* **Option A (Recommended for stable use):** Download the latest release package from the project's **Releases Page**, and extract it to your desired base directory (we will use `/opt/luweb` in this guide).
+
+* **Option B (For development):** Clone the Git repository directly.
+
+```bash
+# Clone the repository into /opt/luweb
+git clone [https://git.geigernet.eu/rainer/luanti-web.git](https://git.geigernet.eu/rainer/luanti-web.git) /opt/luweb
+```
+
+### 3. Set Permissions
+
+After placing the files, navigate to the project directory and make all main scripts executable.
+
+```bash
+cd /opt/luweb
+chmod +x generate_map.sh generate_site.sh check_server_status.sh check_dependencies.sh sync_players.sh sync_areas.sh
+```
+
+### 4. Global Configuration
+
+The central configuration file for the entire toolkit is `config.sh`. You **must** edit this file and adjust the paths to match your server's environment.
+
+**Key variables to edit in `config.sh`:**
+
+* `BASE_SCRIPT_DIR`: The absolute path to the project's root directory (e.g., `/opt/luweb`).
+* `MINETESTMAPPER_WORLD_DATA_BASE_PATH`: The absolute path to the directory containing all your Minetest world data folders (e.g., `/opt/minetest/worlds/`).
+* `WEB_ROOT_PATH`: The absolute path to the document root of your website where the generated files will be placed (e.g., `/var/www/yourdomain.com/html`).
+* `LOG_DIR_BASE`: A directory where the scripts can write their log files (e.g., `/var/log/luweb`). Ensure the user running the scripts has write permissions to this directory.
+
+### 5. Final Verification
+
+Once you have completed the steps above, run the dependency checker from within the project directory to ensure everything is set up correctly.
+
+```bash
+./check_dependencies.sh
+```
+
+If this script completes with the message "Alle geprüften Abhängigkeiten sind vorhanden. Das System ist startklar." (All checked dependencies are present. The system is ready to go.), the installation is successful.
+
+You can now proceed to the **[[Configuration]]** page to learn how to set up your individual worlds.
\ No newline at end of file