diff --git a/Troubleshooting.md b/Troubleshooting.md
new file mode 100644
index 0000000..9bf8025
--- /dev/null
+++ b/Troubleshooting.md
@@ -0,0 +1,51 @@
+# Troubleshooting
+
+## Häufige Probleme
+
+### Port nicht erkannt
+
+```bash
+ls /dev/ttyUSB*
+ls /dev/ttyACM*
+```
+
+### PlatformIO fehlt
+
+```bash
+python3 -m pip install platformio
+```
+
+### Upload schlägt fehl
+
+- Port prüfen
+- Board neu starten
+- USB-Kabel prüfen
+- erneut versuchen
+
+### Sensorwerte unplausibel
+
+- Dichtheit prüfen
+- Schläuche prüfen
+- Spannung messen
+- GND prüfen
+
+### Warnleuchte misst falsch
+
+- Spannungsteiler prüfen
+- ADC-Filter prüfen
+- 15V Worst-Case berücksichtigen
+
+## Empfohlener Ablauf
+
+1. Versorgung prüfen
+2. GND prüfen
+3. Port prüfen
+4. Build und Upload
+5. Serial Monitor starten
+6. Sensoren und Schläuche prüfen
+
+## Verweise
+
+- [Build](Build.md)
+- [Assembly](Assembly.md)
+- [Setup](Setup.md)