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.
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 | — |
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.
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:
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
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".
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.
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.
spart, kann den Kern durch einen Download der gleichen Fassung ersetzen und
nur config/, apps/ (eigene) und die Nutzdaten mitnehmen.
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).
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'
Damit der Knopf überhaupt durchläuft, waren drei Fehler zu beheben (alle in
docs\30-PANEL-STREAKS.md beschrieben):
neu03-3.sh — der Sammellauf sucht neu03-3-*.shund fand nichts („Schritt 3 hat kein Skript"). Jetzt sprechende Namen
(neu03-3-grundausstattung.sh).
$(…/neu03.env; echo $NAME) — die Datei wurde ausgeführt statt eingelesen, NAME blieb leer, alle Schritte
liefen ohne Host. Jetzt $(. …/neu03.env; echo $NAME).
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.