# GPLX – Deploy auf IONOS VPS

Zielumgebung: IONOS VPS oder Cloud Server mit Root-SSH-Zugang, Debian/Ubuntu.

---

## Ausgangssituation: Fehlerhafter Docker-Betrieb auf dem Server

Die aktuell laufende MediaWiki-Instanz auf dem IONOS-Server basiert auf Docker (vermutlich `docker-compose` mit separaten Containern für PHP/Apache und MariaDB). Diese Installation ist fehlerhaft und soll durch eine native Apache-PHP-Installation ersetzt werden.

**Vor dem Deploy prüfen / aufräumen:**

```bash
# Laufende Container anzeigen
docker ps -a

# Volumes anzeigen (wichtig: ggf. Datenbankdaten sichern!)
docker volume ls

# Alle Container stoppen und entfernen
docker compose down
# oder, falls kein compose-File mehr vorhanden:
docker stop $(docker ps -aq) && docker rm $(docker ps -aq)

# Volumes nur entfernen, wenn kein Datenbank-Backup mehr benötigt wird
docker volume prune
```

> **Achtung:** Falls noch Nutzer-Inhalte oder Uploads im Docker-Volume liegen, diese vorher mit `docker cp <container>:/var/www/html/images ./images-backup` sichern.

---

## 1. Server-Voraussetzungen

SSH auf den Server, dann:

```bash
apt update && apt install -y apache2 php8.3 php8.3-mysql php8.3-xml \
  php8.3-mbstring php8.3-intl php8.3-curl php8.3-gd php8.3-zip \
  mariadb-server git
```

---

## 2. Code auf den Server bringen

### Option A: über ein Git-Remote

```bash
# lokal – einmalig ein Remote hinzufügen
git remote add ionos ssh://root@<server-ip>/var/www/gplx
git push ionos main
```

### Option B: direkt auf dem Server klonen

```bash
cd /var/www
git clone <git-remote-url> gplx
```

---

## 3. MySQL-Datenbank einrichten

```bash
mysql -u root -p
```

```sql
CREATE DATABASE gplx CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gplx'@'localhost' IDENTIFIED BY 'STRONG_PASSWORD';
GRANT ALL PRIVILEGES ON gplx.* TO 'gplx'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```

---

## 4. LocalSettings.php anpassen

Drei Stellen müssen auf Produktionswerte geändert werden:

```php
// Server-URL
$wgServer = "https://yourdomain.de";

// Datenbank
$wgDBserver   = "localhost";
$wgDBname     = "gplx";
$wgDBuser     = "gplx";
$wgDBpassword = "STRONG_PASSWORD";

// Semantic MediaWiki (im ExtensionFunctions-Hook)
enableSemantics( 'yourdomain.de' );   // Domain ohne Protokoll und Port
```

Neuen Secret Key generieren (der aktuelle ist im Git-Verlauf):

```bash
openssl rand -hex 32
```

Den generierten Wert als `$wgSecretKey` eintragen.

---

## 5. Datenbank-Tabellen anlegen

Da die Datenbank neu und leer ist, reicht `update.php`:

```bash
cd /var/www/gplx/mediawiki
php maintenance/run.php update --quick
```

---

## 6. SMW-Tabellen einrichten

```bash
php extensions/SemanticMediaWiki/maintenance/setupStore.php --nochecks
```

---

## 7. Apache-Vhost konfigurieren

Datei `/etc/apache2/sites-available/gplx.conf` anlegen:

```apache
<VirtualHost *:80>
    ServerName yourdomain.de
    DocumentRoot /var/www/gplx/mediawiki

    <Directory /var/www/gplx/mediawiki>
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>
```

```bash
a2enmod rewrite
a2ensite gplx
a2dissite 000-default
systemctl reload apache2
```

Für HTTPS (empfohlen) Certbot nachinstallieren:

```bash
apt install -y certbot python3-certbot-apache
certbot --apache -d yourdomain.de
```

---

## 8. Dateisystem-Berechtigungen

```bash
chown -R www-data:www-data /var/www/gplx/mediawiki/images
chmod -R 755 /var/www/gplx/mediawiki/images
```

---

## 9. Smoke-Test

1. `https://yourdomain.de` im Browser öffnen – Startseite muss laden.
2. Als Admin einloggen und eine Testseite erstellen.
3. SMW-Abfrage prüfen: `Special:Ask` aufrufen.
4. Accessibility-Check lokal gegen die Live-URL laufen lassen:
   ```bash
   npm run a11y:all
   ```
   (Pa11y-Ziel-URL in `tests/accessibility/pa11y.config.json` vorher anpassen.)

---

## Wichtige Gotchas

| Problem | Ursache | Lösung |
|---|---|---|
| SMW speichert keine Eigenschaften | `enableSemantics()` enthält noch `127.0.0.1:8080` | Domain in LocalSettings.php korrigieren, `rebuildData.php` ausführen |
| Seiten zeigen "Page Not Available" | ApprovedRevs aktiv, keine genehmigte Version | Als Admin einloggen und Revision genehmigen |
| 500-Fehler nach Deploy | `$wgShowExceptionDetails = true` für Debug, danach wieder entfernen | Fehlermeldung lesen, dann deaktivieren |
| Images-Ordner nicht beschreibbar | Falscher Owner nach `git clone` | `chown -R www-data:www-data images/` |
| Apache startet nicht (Port 80 belegt) | Docker-Container läuft noch und hält Port 80 | `docker compose down` oder `docker stop $(docker ps -aq)` |