docs: add Docker migration notes and bare-repo deploy setup

This commit is contained in:
Sascha 2026-06-05 15:32:22 +02:00
parent 3a6ea4ca62
commit a49ce5be02
1 changed files with 27 additions and 0 deletions

View File

@ -4,6 +4,32 @@ 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:
@ -160,3 +186,4 @@ chmod -R 755 /var/www/gplx/mediawiki/images
| 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)` |