Troubleshooting¶
Netzwerk¶
Bridge zeigt NO-CARRIER oder DOWN¶
# Status pruefen
ip link show br0
ip link show enp4s0 | grep "link/ether" # Muss: 10:7c:61:4f:28:62
ip link show br0 | grep "link/ether" # Muss identisch sein
# Config pruefen
cat /etc/netplan/99-br0.yaml
# Safe-Apply (mit Rollback)
sudo netplan-safe-apply.sh 120
Haeufige Ursachen:
- Leere
interfaces: []in Netplan - Fehlende
macaddressauf Bridge - IPs auf enp4s0 statt br0
Kein Internet-Zugriff¶
# Gateway erreichbar?
ping -c1 46.4.96.129
# DNS funktioniert?
dig google.com
# Traefik laeuft?
sudo docker compose ps traefik
Docker¶
Container startet nicht¶
# Logs pruefen
sudo docker compose -f /etc/xynap/stack/docker-compose.yml logs <service>
# Container-Details
sudo docker inspect <container>
# Force-Recreate
sudo docker compose up -d --force-recreate <service>
GPU nicht erkannt (Ollama)¶
# GPU-Status
nvidia-smi
# Container force-recreate (nicht nur restart!)
sudo docker rm -f ollama
sudo docker compose -f /etc/xynap/stack/docker-compose.yml up -d ollama
Nach Host-Reboot
GPU-Container muessen force-recreated werden (stale cgroup BPF filter).
Platform API verbindet nicht zu DB¶
# MariaDB laeuft?
sudo docker compose ps mariadb
# DB-Zugang testen
sudo docker compose exec mariadb mariadb -u platform -pplatform2024 xynap_platform -e "SELECT 1"
Mail¶
Postfix Queue voll¶
# Queue-Status
sudo docker compose exec hosting-postfix mailq
# Queue leeren (Vorsicht!)
sudo docker compose exec hosting-postfix postsuper -d ALL
Dovecot Verbindungsprobleme¶
# SSL-Modus pruefen
# ssl = yes (nicht required) fuer interne Verbindungen von Roundcube
sudo docker compose exec hosting-dovecot doveconf ssl
FreeSwitch¶
SIP-Registrierung schlaegt fehl¶
# FreeSwitch CLI
sudo docker compose exec freeswitch fs_cli
# Registrierungen anzeigen
sofia status profile internal reg
# Gateway-Status
sofia status gateway <name>
WebRTC funktioniert nicht¶
# WSS-Port (7443) offen?
sudo ufw status | grep 7443
# FreeSwitch Logs
sudo docker compose logs -f freeswitch | grep WSS
SSL¶
Zertifikat laeuft ab¶
# Zertifikate pruefen
sudo docker compose exec traefik cat /letsencrypt/acme.json | python3 -m json.tool | grep -A2 "domain"
# Traefik-Sync manuell triggern (passiert auch bei API-Restart)
sudo docker compose restart platform-api
Allgemein¶
Logs aller Services¶
# Alle Logs (letzte 100 Zeilen)
sudo docker compose -f /etc/xynap/stack/docker-compose.yml logs --tail 100
# Bestimmter Service, live
sudo docker compose -f /etc/xynap/stack/docker-compose.yml logs -f <service>