Bevor Sie n8n, Python-Skripte oder Datenbanken in isolierten Umgebungen ausführen können, müssen Sie die Laufzeit-Engine installieren: Docker.
Viele Tutorials behandeln die Docker-Installation als trivialen "Weiter klicken"-Prozess. Das ist gefährlich. Docker ist keine einfache Anwendung; es ist ein Hypervisor-Manager, der eine Linux Virtual Machine (VM) auf Ihrem Host-Betriebssystem erstellt. Das Verständnis dieser Architektur ist der Schlüssel zur Fehlerbehebung, wenn etwas schief geht.
Hier ist der rigorose, architektonische Leitfaden zur korrekten Installation von Docker Desktop auf macOS und Windows.
Die Architektur (Mac)
MacOS ist Unix-basiert, was es näher an Linux als Windows ist, aber es kann Linux-Binärdateien (Container) immer noch nicht nativ ausführen. Docker Desktop auf dem Mac verwendet das Apple Hypervisor Framework, um eine leichtgewichtige Linux-VM im Hintergrund auszuführen.
Schritt 1: Die richtige Architektur auswählen
⚠️ Häufigster Fehlerpunkt: Sie müssen die für Ihren spezifischen CPU-Befehlssatz kompilierte Binärdatei herunterladen.
- Apple Silicon (M1/M2/M3/Pro/Max): Sie verlassen sich auf die ARM64-Architektur. Das Herunterladen der Intel-Version zwingt Ihren Mac, "Rosetta 2"-Übersetzung zu verwenden, was massiven Performance-Overhead und Instabilität für Docker erzeugt.
- Intel-Chip: Sie verlassen sich auf die x86_64-Architektur.
Schritt 2: Installation & Berechtigungen
- Öffnen Sie die .dmg-Datei.
- Ziehen Sie das Docker-Symbol in den Programme-Ordner.
- Kritischer Schritt: Doppelklicken Sie auf Docker, um es zu starten. Es wird nach Ihrem Systempasswort fragen.
Warum? Docker muss Privileged Helper Tools installieren. Dies sind Netzwerkkomponenten, die es dem Container (innerhalb der VM) ermöglichen, mit Ihren macOS-Host-Ports zu kommunizieren (z.B. Port 5678 zuordnen). Sie müssen dies erlauben.
Schritt 3: Ressourcenzuweisung (Der versteckte Engpass)
Standardmäßig könnte Docker zu viel oder zu wenig RAM beanspruchen.
2. Arbeitsspeicher: Weisen Sie mindestens 4GB zu (idealerweise 8GB, wenn Sie 16GB+ insgesamt haben)
3. CPUs: Weisen Sie mindestens 2 zu
4. Swap: Standard beibehalten
Die Architektur (Windows)
Windows verwendet den NT-Kernel, der grundsätzlich inkompatibel mit Linux-Containern ist. Historisch verwendete Docker eine schwere VM (Hyper-V). Heute ist der Goldstandard WSL 2 (Windows Subsystem for Linux 2).
WSL 2 führt einen echten Linux-Kernel neben dem Windows-Kernel mit leichtgewichtiger Virtualisierung aus. Dies bietet nahezu native Performance.
Schritt 0: Voraussetzungen (BIOS/UEFI)
Bevor Sie Software installieren, müssen Sie sicherstellen, dass Ihre Hardware Virtualisierung zulässt.
2. Gehen Sie zum Leistung-Tab > CPU
3. Suchen Sie nach Virtualisierung: Aktiviert
Falls Deaktiviert: Sie müssen Ihren Computer neu starten, ins BIOS gehen (F2 oder Entf) und Intel VT-x oder AMD-V aktivieren.
Schritt 1: Docker Desktop installieren
- Laden Sie das Installationsprogramm von Docker.com herunter.
- Führen Sie das Installationsprogramm aus.
- Kritisches Kontrollkästchen: Stellen Sie sicher, dass "WSL 2 anstelle von Hyper-V verwenden" aktiviert ist.
Warum? Hyper-V ist das Legacy-Backend. Es ist langsamer und reserviert System-RAM, selbst wenn Container nicht laufen. WSL 2 ist dynamisch und effizient.
Schritt 2: Das WSL-Update (Häufiger Fehler)
Während der Installation könnte Docker Sie darauf hinweisen, dass "WSL 2-Installation unvollständig ist."
2. Führen Sie aus: wsl --update
3. Führen Sie aus: wsl --shutdown (um das Subsystem neu zu starten)
Schritt 3: Überprüfung
2. Warten Sie, bis der Engine Starting-Status (Wal-Symbol) grün wird
Unabhängig von Ihrem Betriebssystem müssen Sie überprüfen, dass die Engine tatsächlich Images aus der Registry ziehen und einen Container starten kann.
Öffnen Sie Ihr Terminal (Terminal.app auf dem Mac, PowerShell unter Windows) und führen Sie aus:
Die Physik dessen, was gerade passiert ist:
- Client: Ihr Terminal hat eine Anfrage an den Docker-Daemon (Hintergrunddienst) gesendet.
- Prüfen: Der Daemon hat den lokalen Speicher nach einem Image namens hello-world durchsucht.
- Pull: Er hat es nicht gefunden, also hat er sich mit Docker Hub (Cloud) verbunden und die Schichten heruntergeladen.
- Run: Er hat einen neuen Container-Prozess erstellt, das Skript darin ausgeführt, die Textausgabe zu Ihrem Terminal gestreamt und dann heruntergefahren.
✓ Erfolg: Wenn Sie die Nachricht "Hello from Docker!" sehen, ist Ihre Engineering-Grundlage solide. Sie sind bereit, n8n oder jeden anderen containerisierten Dienst zu installieren.