Troubleshooting¶
Network¶
Bridge shows NO-CARRIER or 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
Common causes:
- Empty
interfaces: []in Netplan - Missing
macaddresson Bridge - IPs on enp4s0 instead of br0
No Internet access¶
# Gateway erreichbar?
ping -c1 46.4.96.129
# DNS funktioniert?
dig google.com
# Traefik laeuft?
sudo docker compose ps traefik
Docker¶
Container does not start¶
# 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 not recognized (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
After host reboot
GPU container must be force-recreated (stale cgroup BPF filter).
Platform API does not connect to 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 full¶
# Queue-Status
sudo docker compose exec hosting-postfix mailq
# Queue leeren (Vorsicht!)
sudo docker compose exec hosting-postfix postsuper -d ALL
Dovecot connection problems¶
# SSL-Modus pruefen
# ssl = yes (nicht required) fuer interne Verbindungen von Roundcube
sudo docker compose exec hosting-dovecot doveconf ssl
FreeSwitch¶
SIP registration fails¶
# FreeSwitch CLI
sudo docker compose exec freeswitch fs_cli
# Registrierungen anzeigen
sofia status profile internal reg
# Gateway-Status
sofia status gateway <name>
WebRTC does not work¶
# WSS-Port (7443) offen?
sudo ufw status | grep 7443
# FreeSwitch Logs
sudo docker compose logs -f freeswitch | grep WSS
SSL¶
Certificate releases¶
# 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
General¶
Logs of all 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>