Troubleshooting – schnelle Hilfe

1) E-Mails kommen nicht an / gehen nicht raus

• Prüfe Online/IMAP/SMTP: Flugmodus aus, Internet aktiv.
• IMAP: Port 993, SSL/TLS · SMTP: Port 587, STARTTLS.
• Nutzername = volle E-Mail-Adresse. 2FA? → App-Passwort nutzen.
• Spam/Quarantäne prüfen. Große Anhänge (< 20 MB) oder Cloud-Link senden.
• Test: an eigene Adresse mailen, in Gesendet prüfen.

2) Webmail Login schlägt fehl

• Richtige Domain? (Firmen-Webmail-URL)
• Passwort sichtbar tippen (neues Tab: about:blank, dann kopieren).
• Tastaturlayout prüfen (DE/EN), Caps Lock aus.
• 2FA-App: korrekte Zeit synchronisiert? (Automatisch/Zeitserver)
• Zur Not: „Passwort vergessen“ → Recovery/Helpdesk.

3) Discord: kein Ton / Mic geht nicht

• In Discord Einstellungen → Sprache & Video:
  • Ein-/Ausgangsgerät korrekt?
  • „Eingangsmodus: Sprachaktivierung“ testweise statt Push-to-Talk.
• OS-Audio prüfen (richtiger Output), Lautstärke ≠ 0, Mic nicht gemutet.
• Browser-Discord? → App testen (oder umgekehrt).
• Linux: pavucontrol öffnen, App/Device zuordnen.

4) DNS/Seiten laden langsam oder gar nicht

• Test: nslookup wiki.kit-it-koblenz.de / ping -c 1 host.
• DNS ändern (temporär): 1.1.1.1 / 9.9.9.9 / 8.8.8.8.
• Browser-Cache leeren / anderen Browser testen.
• VPN aktiv? → kurz trennen und nochmal testen.

5) VPN verbindet nicht

• Anmeldedaten/2FA korrekt? Uhrzeit des Geräts korrekt?
• Prüfe Netz: Gäste-WLAN oder Mobil-Hotspot blockiert ggf. VPN.
• Firewall/AV temporär testen (deaktivieren → Test → wieder aktivieren).
• Event-Log/Client-Log kopieren → an Admin/Support.

6) Drucker druckt nicht

• Gerät online? Papier/Toner? Stau entfernen.
• Richtigen Queue/Modelltreiber gewählt?
• Testseite lokal drucken; wenn ok → App/Datei-Problem.
• Netzwerkdrucker: IP erreichbar? (Ping), ggf. neu verbinden.

---

7) SSH-Verbindung schlägt fehl

• Host erreichbar? → ping <host> / telnet <host> 22
• Port offen? → Standard SSH = Port 22, bei Custom-Port prüfen
• SSH-Key korrekt? → ssh -i ~/.ssh/id_ed25519 user@host
  • Permissions: chmod 600 ~/.ssh/id_ed25519 (zu offen = Fehler!)
• Known Hosts Problem? → ssh-keygen -R <hostname> (bei Host-Key-Change)
• Firewall/VPN? → Manche Hosts nur über VPN erreichbar
• Verbose Debug: ssh -vvv user@host → Logs zeigen wo’s hängt

# Quick-Check SSH
ssh -v user@host 2>&1 | grep -i "debug\|error\|denied"

---

8) Git Push/Pull Probleme

„Permission denied (publickey)”

• SSH-Key nicht im SSH-Agent? → ssh-add ~/.ssh/id_ed25519
• Key bei GitHub/GitLab hinterlegt? → Check Settings → SSH Keys
• Test: ssh -T git@github.com (sollte Begrüßung zeigen)

„Authentication failed” (HTTPS)

• Personal Access Token statt Passwort nutzen (GitHub/GitLab)
• Token im Credential-Store? → git config credential.helper store

„Merge conflict” / kann nicht pullen

git status              # Konflikte anzeigen
git stash               # Lokale Änderungen sichern
git pull                # Pullen
git stash pop           # Änderungen zurückholen
# Oder: Konflikte manuell in Files lösen, dann commit

Push rejected (non-fast-forward)

git pull --rebase       # Remote-Changes einbinden
git push                # Nochmal pushen

---

9) Langsames System / Hohe CPU-Last

Linux:

top                     # Prozesse live (q = quit)
htop                    # Übersichtlicher (installieren!)
ps aux | sort -k 4 -r | head -10  # Top 10 nach CPU
journalctl -xe          # System-Logs checken

• Docker? → docker stats (Container-Ressourcen)
• Zombie-Prozess? → kill -9 <PID>
• Disk I/O? → iotop (zeigt Disk-intensive Prozesse)

Typische Übeltäter:

• Chrome/Firefox mit 100+ Tabs
• Runaway Docker Container (Memory-Leak)
• IDE Indexing (VS Code, IntelliJ)
• Backup-Software läuft im Hintergrund

---

10) Docker Container starten nicht

Port bereits belegt:

# Error: "bind: address already in use"
sudo netstat -tulpn | grep :<PORT>  # Welcher Prozess nutzt den Port?
sudo lsof -i :<PORT>                # Alternative

# Port freigeben oder Container-Port ändern:
docker run -p 8081:80 nginx  # Nutze 8081 statt 8080

Image nicht gefunden:

docker pull <image>     # Manuell pullen
docker images           # Vorhandene Images checken

Volume/Permission-Fehler:

# Error: "permission denied"
ls -la /path/to/volume  # Wem gehört das Volume?
sudo chown -R $USER:$USER /path/to/volume

Netzwerk-Probleme:

docker network ls       # Netzwerke anzeigen
docker network inspect <network>  # Details
docker-compose down && docker-compose up  # Neustart

---

11) Festplatte voll / Disk Space kritisch

Schnell-Check:

df -h                   # Partitionen & Nutzung
du -sh /* | sort -h     # Größte Ordner im Root (dauert!)
du -sh ~/Downloads ~/.cache /tmp  # Typische Speicherfresser

Was aufräumen?

# 1) Docker cleanup (oft GIGABYTE frei!)
docker system prune -a --volumes  # Alle ungenutzten Images/Volumes

# 2) Paketmanager-Cache
sudo apt clean          # Debian/Ubuntu
sudo dnf clean all      # Fedora/RHEL

# 3) Journald-Logs (systemd)
sudo journalctl --vacuum-size=100M  # Logs auf 100MB reduzieren

# 4) Alte Kernels (Ubuntu/Debian)
sudo apt autoremove     # Entfernt alte Kernel

# 5) Temp-Files
rm -rf ~/.cache/*       # User-Cache
sudo rm -rf /tmp/*      # System-Temp (Vorsicht!)

Große Dateien finden:

# Top 20 größte Dateien im Home
find ~ -type f -exec du -h {} + | sort -rh | head -20

---

12) Port ist bereits belegt

# Error: "Address already in use" / "Port 8080 already in use"

# 1) Welcher Prozess nutzt den Port?
sudo lsof -i :8080              # Linux/macOS
sudo netstat -tulpn | grep 8080 # Linux

# 2) Prozess killen (falls unnötig)
sudo kill <PID>          # Graceful
sudo kill -9 <PID>       # Force-Kill

# 3) Oder: Anderen Port nutzen
# Statt Port 8080 → 8081, 3001, etc.

Windows:

netstat -ano | findstr :8080    # PID finden
taskkill /PID <PID> /F           # Prozess beenden

---

13) SSL/TLS Zertifikat-Fehler im Browser

„Deine Verbindung ist nicht privat” / NET::ERR_CERT_

Ursachen:

• Self-Signed Cert (Dev-Umgebung) → Akzeptabel für lokale Entwicklung
• Abgelaufenes Zertifikat → Administrator muss erneuern
• Falsche System-Zeit → Uhrzeit checken! (siehe 2FA-Troubleshooting)
• Corporate Proxy/Antivirus → Zertifikat-Chain unterbrochen

Temporäre Lösung (NUR für Dev/Testing):

• Chrome: Tippe thisisunsafe auf der Fehlerseite (kein Button, einfach tippen!)
• Firefox: „Risiko akzeptieren” → „Ausnahme hinzufügen”

Langfristige Lösung:

# Zertifikat-Details checken
openssl s_client -connect wiki.kit-it-koblenz.de:443 -showcerts

# Eigene Zertifikate (Linux)
sudo update-ca-certificates      # Debian/Ubuntu
sudo update-ca-trust             # RHEL/Fedora

---

14) Nvidia-Treiber-Probleme (Linux)

Schwarzer Bildschirm nach Update / Kein X-Server

# 1) Fallback: Nouveau-Treiber (Open Source)
sudo systemctl isolate multi-user.target  # TTY-Mode
sudo apt remove --purge nvidia-*          # Nvidia entfernen
sudo apt install xserver-xorg-video-nouveau
sudo reboot

# 2) Nvidia neu installieren (Ubuntu)
sudo ubuntu-drivers autoinstall           # Automatisch
# Oder manuell: sudo apt install nvidia-driver-535

# 3) Check welcher Treiber läuft
nvidia-smi                                # Nvidia-Tool
lsmod | grep -i nvidia                    # Kernel-Module

---

15) WiFi langsam / verbindet nicht

Grundlagen:

# Signal-Stärke checken (Linux)
iwconfig                        # Interface + Signal
nmcli dev wifi list             # Verfügbare Netzwerke

# DNS-Test (langsame Verbindung oft DNS-Problem!)
nslookup google.com             # Dauert > 2 Sek? DNS-Problem!

Fixes:

• Anderer WLAN-Kanal (Router Admin-Panel) → 1/6/11 (2.4GHz) nutzen
• 5GHz statt 2.4GHz nutzen (weniger Interferenzen)
• Treiber-Update (Windows Device Manager / Linux Kernel)
• DNS ändern → 1.1.1.1 oder 9.9.9.9 (temporär testen)
• Firewall/VPN temporär deaktivieren (zum Test)

---

Mehr Probleme? Schreib ins #support (Discord) oder mail support@kit-it-koblenz.de 🤝