← zur Übersicht

Server 03 (Nextcloud + Avatar-Beratung) wieder aufbauen


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.

BausteinFassung / OrtPort
Nextcloud34.0.2.1, /var/www/nextcloud, Daten in /var/www/nextcloud-dataüber nginx
MariaDB10.11.14, Datenbank nextcloud (25,7 MB, 131 Tabellen)127.0.0.1:3306
PHP8.3.6 mit FPM9000 (Socket)
nginx1.24, drei Seiten80/443
redis-serverPaket6379
avatar-aiNode, /var/www/avatar-ai/server.js, über pm23000
avatar-chatVite/React-Build, /var/www/avatar-chat (178 MB)statisch
avatar-agentPython, /root/avatar-keyframe/avatar_agent.py (LiveKit, bitHuman)—
avatar-mail-watcherPython, verschickt Gespräche per Mail—
postfixlokaler Versand25
Domainsavatarredet.unsere-ki-runde.xyz (→3000), nextcloud.ichselbstreal.site, beratung.unsere-ki-runde.xyz—

2. Sicherung

Bauen: sudo -n bash hilfsskripte/03-paket-bauen.sh

DateiInhaltGröße
03-nextcloud-paket.tar.gzNextcloud-Kern + eigene Apps, Nutzdaten, avatar-ai, avatar-chat, website, /root/avatar-keyframe, nginx-Sites, Zertifikate, PHP-Pool, Agenten-Einheiten1,1 GB
03-nextcloud-db.sql.gzmysqldump --single-transaction --routines --events der Datenbank nextcloud4,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:

PhaseTagWas
1paketenginx, certbot, mariadb, redis, postfix (ohne Rückfragen), PHP 8.3 + 15 Erweiterungen
2dateienPaket + Dump hochladen, entpacken, Datenbank-Zugang aus config.php lesen, Datenbank anlegen und Dump einspielen, Rechte auf www-data
3diensteNode 20, pm2, avatar-ai, php-fpm, nginx
4agentenvenv + Abhängigkeiten, avatar-agent und avatar-mail-watcher
5webserverdie drei nginx-Seiten verknüpfen
6zertifikatcertbot für die drei Namen
7abnahmeocc 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

4. Geprüft am 31.10.2026 (Testserver wegwerf-03-nextcloud)

PrüfungErgebnis
Laufok=32 changed=13 failed=0
Datenbank131 Tabellen eingespielt
Nextcloudinstalled: true, version: 34.0.2.1, needsDbUpgrade: false
MariaDB / redis / PHP-FPM / nginxalle active
avatar-ailä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

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).

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).

SchrittDauerErgebnis
1 Server anlegen~1 Minwegwerf-03-nextcloud, Adresse 49.12.10.194, SSH nach 25 s
2 DNS—übersprungen (keine Test-Domain eingetragen)
3 Grundausstattung~4 Minnginx, MariaDB, redis, PHP 8.3 aktiv
4 Dateien und Datenbank~9 Min1,1 GB + 4,3 MB Abzug → 131 Tabellen
5 Dienste~2 Minpm2, avatar-ai (PID), php-fpm, nginx
6 Webserver und Zertifikat~1 MinSeiten aus der Sicherung verknüpft
7 Abnahme~1 Mininstalled: 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):

und fand nichts („Schritt 3 hat kein Skript"). Jetzt sprechende Namen

(neu03-3-grundausstattung.sh).

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.