Ruhezustand und Energie

Den Mac im Terminal mit caffeinate wach halten

Der Befehl caffeinate verhindert, dass der Mac in den Ruhezustand wechselt, während eine Aufgabe läuft. Er gehört zu macOS und ändert keine Einstellungen.

Gilt für: alle aktuellen macOS-Versionen. Die Pfade in den Systemeinstellungen gelten ab macOS 13 Ventura.Geprüft: 29. Oktober 2026

Symptome

  • Ein Download, Build oder Skript bricht ab, wenn der Mac in den Ruhezustand wechselt.
  • Eine Remote-Sitzung oder SSH-Verbindung bricht nach einigen Minuten ohne Eingabe ab.
  • Der Mac soll für eine Aufgabe wach bleiben, aber du willst die Einstellungen für den Ruhezustand nicht ändern.

Mögliche Ursachen

  • Ruhezustand bei Inaktivität. macOS versetzt den Mac nach einer Zeit ohne Tastatur- oder Mauseingabe in den Ruhezustand. Netzwerkaktivität allein verhindert das nicht immer.
  • Ruhezustand des Displays. Das Display schaltet sich nach einem eigenen Timer aus. Bei manchen Macs wechselt dann auch das System in den Ruhezustand.
  • Der Deckel. Wenn du den Deckel eines Mac-Laptops schließt, wechselt er in den Ruhezustand. caffeinate ändert daran nichts. Siehe Mac-Laptop bei geschlossenem Deckel weiter nutzen.

So prüfst du es

  1. Öffne das Terminal. Sieh nach, welche Prozesse gerade den Ruhezustand verhindern.

    pmset -g assertions

    Ausgabe Eine Liste von Assertions wie PreventUserIdleSystemSleep, jeweils mit dem Prozess, der sie hält.

  2. Zeige die aktuell verwendeten Einstellungen für den Ruhezustand an.

    pmset -g

So behebst du es

  1. Damit der Mac wach bleibt, solange ein Befehl läuft, setze caffeinate -i vor den Befehl. Die Assertion endet, wenn der Befehl endet.

    caffeinate -i make

  2. Damit der Mac für eine feste Zeit wach bleibt, gib die Zeit in Sekunden mit -t an. Dieses Beispiel steht für zwei Stunden.

    caffeinate -i -t 7200

  3. Damit der Mac wach bleibt, bis ein Prozess endet, gib dessen Prozess-ID mit -w an.

    caffeinate -i -w 12345

  4. Damit auch das Display an bleibt, füge -d hinzu.

    caffeinate -d -i

  5. Um ein ohne Befehl gestartetes caffeinate zu beenden, drücke Control-C.

  6. Um den automatischen Ruhezustand bei ausgeschaltetem Display zu verhindern, ändere die Einstellung. Wähle auf einem Mac-Laptop Apple-Menü > „Systemeinstellungen“ > „Batterie“ > „Optionen“. Aktiviere „Automatischen Ruhezustand bei Verwendung des Netzteils verhindern, wenn das Display ausgeschaltet ist“.

  7. Wähle auf einem Desktop-Mac Apple-Menü > „Systemeinstellungen“ > „Energie“. Aktiviere „Automatischen Ruhezustand verhindern, wenn das Display ausgeschaltet ist“.

Mit Kilobat

  1. Kilobat kann den Mac wach halten, bis ein Download zur Ruhe kommt, und ihn dann schlafen lassen. Öffne Kilobat in der Menüleiste. Klicke auf die Teetasse und wähle „Bis Downloads fertig sind“.

  2. Die CLI macht dasselbe. Sie hört nach 3 Minuten unter 16 KB/s auf.

    kilobat awake --until-quiet

  3. Damit der Mac wach bleibt, solange ein Befehl läuft, und um zu sehen, wie viele Daten er übertragen hat, nutze awake --.

    kilobat awake -- make release

  4. Diese Funktionen sind kostenlos. Die Schritte für App, CLI und MCP findest du im Rezept.

Fragen

Hält caffeinate den Mac auch bei geschlossenem Deckel wach?

Nein. caffeinate verhindert den Ruhezustand bei Inaktivität. Schließt du den Deckel, wechselt ein Mac-Laptop trotzdem in den Ruhezustand – außer er nutzt ein externes Display, eine externe Tastatur und Strom. Siehe Mac-Laptop bei geschlossenem Deckel weiter nutzen.

Was bewirkt die Option -s?

-s verhindert den System-Ruhezustand. Laut Manpage funktioniert das nur, wenn der Mac am Netzstrom hängt.

Ändert caffeinate meine Einstellungen?

Nein. Es erzeugt Power-Assertions. Sie enden, wenn caffeinate endet.

Quellen

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit man <name> im Terminal.