Der Onboarding-Service ist das Backend für die Account-Erstellung und das initiale Setup auf deinem Matrix-System.
Er übernimmt unter anderem:
Kurz:
Das ist die Backend-Logik hinter dem Join-/Onboarding-Prozess.
/opt/docker/tyf-onboardingtyf-onboardingtyf-onboarding-onboarding/opt/docker/tyf-onboarding/docker-compose.yml/opt/docker/tyf-onboarding/server.js/opt/docker/tyf-onboarding/.env3000/tcp3010 -> 3000tyf-onboarding_defaultproxy-netalwayshttp://matrix-synapse:8008proxy-netdocker ps | grep tyf-onboarding
docker logs -f tyf-onboarding
docker logs --tail=50 tyf-onboarding
docker restart tyf-onboarding
cd /opt/docker/tyf-onboarding
docker compose up -d --build
cd /opt/docker/tyf-onboarding
docker compose down
cat /opt/docker/tyf-onboarding/docker-compose.yml
ls -la /opt/docker/tyf-onboarding
cat /opt/docker/tyf-onboarding/server.js
nano /opt/docker/tyf-onboarding/server.js
sudo cat /opt/docker/tyf-onboarding/.env
sudo nano /opt/docker/tyf-onboarding/.env
cat /opt/docker/tyf-onboarding/server.js.save
truncate -s 0 /opt/docker/tyf-onboarding/server.js.save
sudo truncate -s 0 /var/lib/docker/containers/2c7837671fb7789c6a9678b3dff200b39c66d02efb7e4ef1d4f615f1578c7cd1/2c7837671fb7789c6a9678b3dff200b39c66d02efb7e4ef1d4f615f1578c7cd1-json.log
docker inspect tyf-onboarding
docker inspect --format='
Name: {{.Name}}
Image: {{.Config.Image}}
Status: {{.State.Status}}
RestartPolicy: {{.HostConfig.RestartPolicy.Name}}
Ports:
{{json .NetworkSettings.Ports}}
Networks:
{{range $k, $v := .NetworkSettings.Networks}}- {{$k}} (IP: {{$v.IPAddress}})
{{end}}
Mounts:
{{range .Mounts}}- {{.Source}} -> {{.Destination}} ({{.Type}})
{{end}}
' tyf-onboarding
ss -tulpen | grep 3010
docker network ls | grep -i onboarding
docker network inspect proxy-net
docker network inspect tyf-onboarding_default
docker inspect tyf-onboarding | grep -A 20 Mounts
In den Logs taucht dann auf:
account_existsAccount existiert bereits.Das ist kein Docker-Problem, sondern ein fachlicher Fehler im Onboarding-Prozess.
In den Logs taucht dann auf:
account_deactivatedAccount wurde deaktiviert.Dafür gibt es im Backend einen Reaktivierungs-Endpoint.
In den Logs taucht dann auf:
M_INVALID_USERNAMEUser ID can only contain characters a-z, 0-9, or '=_-./+'Dann ist die Eingabe im Frontend oder Request ungültig.
Dann funktionieren Registrierung, Reaktivierung und Bootstrap nicht mehr.
Prüfen:
docker logs tyf-onboarding
docker ps | grep matrix-synapse
docker network inspect proxy-net
Der Container selbst hat keine Mounts.
Das bedeutet:
Wichtige Dateien liegen auf dem Host unter:
/opt/docker/tyf-onboarding/server.js/opt/docker/tyf-onboarding/.env/opt/docker/tyf-onboarding/docker-compose.yml/opt/docker/tyf-onboarding/DockerfileÄnderungen an server.js auf dem Host wirken nicht automatisch im laufenden Container.
Nach Änderungen brauchst du in der Regel:
cd /opt/docker/tyf-onboarding
docker compose up -d --build
matrix-synapse.env mit Shared Secret und Admin-TokenSYNAPSE_INTERNAL=http://matrix-synapse:8008SHARED_SECRET=...SYNAPSE_ADMIN_TOKEN=...Der Service ist kein statisches Frontend, sondern ein eigenständiges Node.js-Backend.
Er läuft mit:
node server.js
Wichtige Punkte:
30003010.envproxy-net, damit er mit anderen Services sprechen kann.envalways, was Fehler verschleiern kann.envserver.js.save bewusst genutzt wird oder Altlast ist.env und server.js in Backup-Konzept aufnehmendocker ps | grep tyf-onboarding
ss -tulpen | grep 3010
curl http://localhost:3010/health
ls -la /opt/docker/tyf-onboarding
Wenn Onboarding nicht funktioniert, prüfst du zuerst:
tyf-onboarding?3010 offen?.env?matrix-synapse?Dann findest du die meisten Fehler ziemlich direkt.