--- titel: Server 03 (Nextcloud + Avatar-Beratung) wieder aufbauen stand: 31.10.2026, 19:50 zweck: Sicherung, Playbook und geprüfte Ergebnisse für Server 03. --- # Server 03 — Nextcloud und Avatar-Beratung neu aufbauen ## 1. Was auf 03 läuft `srv-nextcloud1` / `03-avatar-beratung-nextcloud` (167.233.254.28, cx23, Ubuntu 24.04). Zugang: `anna2`, Port 2121, nur mit `sudo`. | Baustein | Fassung / Ort | Port | |---|---|---| | **Nextcloud** | 34.0.2.1, `/var/www/nextcloud`, Daten in `/var/www/nextcloud-data` | über nginx | | MariaDB | 10.11.14, Datenbank `nextcloud` (25,7 MB, 131 Tabellen) | 127.0.0.1:3306 | | PHP | 8.3.6 mit FPM | 9000 (Socket) | | nginx | 1.24, drei Seiten | 80/443 | | redis-server | Paket | 6379 | | `avatar-ai` | Node, `/var/www/avatar-ai/server.js`, über pm2 | 3000 | | `avatar-chat` | Vite/React-Build, `/var/www/avatar-chat` (178 MB) | statisch | | `avatar-agent` | Python, `/root/avatar-keyframe/avatar_agent.py` (LiveKit, bitHuman) | — | | `avatar-mail-watcher` | Python, verschickt Gespräche per Mail | — | | postfix | lokaler Versand | 25 | | Domains | `avatarredet.unsere-ki-runde.xyz` (→3000), `nextcloud.ichselbstreal.site`, `beratung.unsere-ki-runde.xyz` | — | ## 2. Sicherung Bauen: `sudo -n bash hilfsskripte/03-paket-bauen.sh` | Datei | Inhalt | Größe | |---|---|---| | `03-nextcloud-paket.tar.gz` | Nextcloud-Kern + eigene Apps, Nutzdaten, avatar-ai, avatar-chat, website, `/root/avatar-keyframe`, nginx-Sites, Zertifikate, PHP-Pool, Agenten-Einheiten | 1,1 GB | | `03-nextcloud-db.sql.gz` | `mysqldump --single-transaction --routines --events` der Datenbank `nextcloud` | 4,3 MB (131 Tabellen) | Ohne `node_modules` und `venv` — die entstehen beim Aufbau neu. Prüfsummen auf beiden Seiten verglichen: gleich. ## 3. Das Playbook `playbooks/03-nextcloud.yml`, sieben Phasen: | Phase | Tag | Was | |---|---|---| | 1 | `pakete` | nginx, certbot, mariadb, redis, postfix (ohne Rückfragen), PHP 8.3 + 15 Erweiterungen | | 2 | `dateien` | Paket + Dump hochladen, entpacken, **Datenbank-Zugang aus `config.php` lesen**, Datenbank anlegen und Dump einspielen, Rechte auf `www-data` | | 3 | `dienste` | Node 20, pm2, `avatar-ai`, php-fpm, nginx | | 4 | `agenten` | venv + Abhängigkeiten, `avatar-agent` und `avatar-mail-watcher` | | 5 | `webserver` | die drei nginx-Seiten verknüpfen | | 6 | `zertifikat` | certbot für die drei Namen | | 7 | `abnahme` | `occ status`, Dienste, Ports | Besonderheit in Phase 2: Die Zugangsdaten der Datenbank werden **aus der mitgelieferten `config.php`** gelesen und daraus Benutzer und Rechte angelegt — so passen Datenbank, Benutzer und Nextcloud-Konfiguration automatisch zusammen, ohne dass ein Passwort im Playbook steht. Aufruf: ```bash ansible-playbook playbooks/03-nextcloud.yml -i inventory/produktion.ini \ -l 03-nextcloud --tags pakete,dateien,dienste,agenten,webserver,zertifikat,abnahme ``` Erstprobe ohne DNS/Zertifikat: `-e "mit_webserver=false mit_zertifikat=false" --tags pakete,dateien,dienste,abnahme` ## 4. Geprüft am 31.10.2026 (Testserver `wegwerf-03-nextcloud`) | Prüfung | Ergebnis | |---|---| | Lauf | `ok=32 changed=13 failed=0` | | Datenbank | **131 Tabellen** eingespielt | | Nextcloud | `installed: true`, `version: 34.0.2.1`, **`needsDbUpgrade: false`** | | MariaDB / redis / PHP-FPM / nginx | alle active | | `avatar-ai` | läuft unter pm2 (PID vergeben), Port 3000 lauscht | `needsDbUpgrade: false` ist der entscheidende Wert: Nextcloud erkennt seine Datenbank als passend zur installierten Fassung — der Stand ist also konsistent, nicht nur „irgendwie gestartet". ## 5. Stolperstein beim Bauen der Sicherung Der erste Abzug scheiterte still: `scp` als `anna2` kann `/root/backup03/` nicht lesen, obwohl die Datei da war (`No such file or directory`). Lösung: Paket erst nach `/tmp` kopieren und dort lesbar machen, dann holen. Steht so im Skript. ## 6. Offene Punkte 1. **`avatar-agent` (Python) und `avatar-chat`-Build** sind im Playbook als Stufe 2 vorgesehen (`mit_agenten`), aber noch nicht durchgetestet — der Test lief ohne sie. 2. **1,1 GB Paket** ist der größte Brocken bisher (Nextcloud-Kern). Wer Platz spart, kann den Kern durch einen Download der gleichen Fassung ersetzen und nur `config/`, `apps/` (eigene) und die Nutzdaten mitnehmen. 3. **postfix** ist auf „Local only" gestellt — reicht für den Mail-Watcher, aber nicht für externen Versand. Wenn Mails über den Mailserver gehen sollen, gehört ein Relay in die Playbook-Phase 1 (wie bei Server 05). ## 7. Ruck-Zuck-Lauf über das Panel (31.10.2026, 20:36–20:54) Zum ersten Mal lief die Strecke **13 · Nextcloud / Avatar** komplett über die Panel-Oberfläche (`https://steuer127.g3.local/`) — ein Klick auf „⏩ Ruck-Zuck", danach die Sicherheitsfrage bestätigen. Protokoll vollständig im Projekt: `docs\belege\20261031-203629-neu03-alles.log` (241 Zeilen). | Schritt | Dauer | Ergebnis | |---|---|---| | 1 Server anlegen | ~1 Min | `wegwerf-03-nextcloud`, Adresse 49.12.10.194, SSH nach 25 s | | 2 DNS | — | übersprungen (keine Test-Domain eingetragen) | | 3 Grundausstattung | ~4 Min | nginx, MariaDB, redis, PHP 8.3 aktiv | | 4 Dateien und Datenbank | ~9 Min | 1,1 GB + 4,3 MB Abzug → **131 Tabellen** | | 5 Dienste | ~2 Min | pm2, avatar-ai (PID), php-fpm, nginx | | 6 Webserver und Zertifikat | ~1 Min | Seiten aus der Sicherung verknüpft | | 7 Abnahme | ~1 Min | `installed: true`, `needsDbUpgrade: false` | **Gesamt: 18 Minuten.** Der lange Teil ist Schritt 4 (Upload der 1,1 GB). Abnahme im Klartext aus dem Protokoll: ``` - ' - installed: true' - ' - version: 34.0.2.1' - ' - needsDbUpgrade: false' - ' mariadb: active' - ' redis: active' - ' php-fpm: active' - ' nginx: active' - ' avatar-ai: 24816' - ' *:3000' ``` ### Was dabei am Panel repariert werden musste Damit der Knopf überhaupt durchläuft, waren drei Fehler zu beheben (alle in `docs\30-PANEL-STREAKS.md` beschrieben): 1. Die Schrittdateien hießen `neu03-3.sh` — der Sammellauf sucht `neu03-3-*.sh` und fand nichts („Schritt 3 hat kein Skript"). Jetzt sprechende Namen (`neu03-3-grundausstattung.sh`). 2. In der Kopfzeile des Sammellaufs stand `$(…/neu03.env; echo $NAME)` — die Datei wurde **ausgeführt** statt eingelesen, `NAME` blieb leer, alle Schritte liefen ohne Host. Jetzt `$(. …/neu03.env; echo $NAME)`. 3. Das Eintragen ins Inventar scheiterte still, weil die **auskommentierte** Zeile `# wegwerf-03-nextcloud … (gelöscht)` den Namen enthielt und als „schon vorhanden" galt. Jetzt werden alle Zeilen mit dem Namen entfernt und die neue eingesetzt.