launchd-Domains: LaunchAgent oder LaunchDaemon wählen und mit launchctl laden

Ziel

Ein Programm installieren, das macOS automatisch startet – entweder bei der Benutzeranmeldung (LaunchAgent) oder beim Systemstart ohne Benutzersitzung (LaunchDaemon) – und es mit den modernen launchctl-Subcommands statt mit dem veralteten Paar load/unload verwalten.

Voraussetzungen

Eine Terminal-Sitzung; ein Programm, auf das über einen absoluten Pfad verwiesen wird; Admin-/sudo-Rechte nur für alles, was ausserhalb des eigenen Home-Verzeichnisses installiert wird. macOS 13 Ventura oder neuer (bootstrap/bootout/kickstart sind seit OS X 10.10 die empfohlene Schnittstelle, die Befehle funktionieren daher auch auf älteren Versionen).

Schritte

1. Domain wählen. Ein LaunchAgent läuft innerhalb der Sitzung eines bestimmten Benutzers und kann auf die GUI zugreifen; er gehört in die Domain gui/<uid> (interaktive Anmeldung) oder user/<uid> (Hintergrund, keine GUI). Ein LaunchDaemon läuft als root ohne Benutzerkontext und gehört in die Domain system.
2. Pfad wählen. ~/Library/LaunchAgents erfordert keine Admin-Rechte und gilt nur für diesen Benutzer. /Library/LaunchAgents wird vom Administrator installiert, läuft aber trotzdem als der Benutzer, der sich gerade anmeldet. /Library/LaunchDaemons wird vom Administrator installiert und läuft als root, unabhängig davon, wer angemeldet ist. /System/Library/LaunchAgents und /System/Library/LaunchDaemons sind Apple vorbehalten und liegen auf dem Signed System Volume; dort dürfen keine Dateien hinzugefügt werden.
3. Die plist schreiben, mindestens mit einem eindeutigen Label in Reverse-DNS-Notation, einem ProgramArguments-Array (kein Shell-String) und RunAtLoad, KeepAlive oder StartInterval.
4. Vor dem Laden validieren: plutil -lint /Library/LaunchDaemons/com.example.worker.plist.
5. Bei einem Daemon die Besitzverhältnisse setzen: sudo chown root:wheel und sudo chmod 644 auf die plist.
6. Laden: sudo launchctl bootstrap system /Library/LaunchDaemons/com.example.worker.plist (Daemon) oder launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.example.agent.plist (Agent, als dieser Benutzer ausführen, ohne sudo).
7. Die Persistenz ergibt sich aus dem Speicherort der Datei: launchd lädt beim Systemstart jede plist in /Library/LaunchDaemons und bei der Anmeldung jede plist in den LaunchAgents-Verzeichnissen. launchctl enable system/com.example.worker hebt lediglich eine Deaktivierung auf (Override, der mit launchctl disable gesetzt wird und ebenfalls Neustarts übersteht); launchctl print-disabled system listet diese Overrides auf.
8. Jetzt starten oder eine laufende Instanz neu starten: launchctl kickstart -k system/com.example.worker.
9. Zum Entfernen: sudo launchctl bootout system/com.example.worker, bevor die plist-Datei gelöscht wird.

Erwartetes Ergebnis

launchctl print system/com.example.worker (bei einem Agent das entsprechende Ziel gui/<uid>/...) zeigt state = running, die PID und den letzten Exit-Status; ein Job, der nicht geladen ist, gibt stattdessen "Could not find service" aus.

Grenzen und Prüfbasis

Die Rollen der Verzeichnisse und die Aufteilung nach Domains stammen aus Apples Technical Note zu Daemons und Agents; die aktuelle Syntax der Subcommands bootstrap/bootout/enable/kickstart/print wird von Apple nicht als Webseite veröffentlicht und ist einer Befehlsreferenz entnommen. Das ältere Paar launchctl load -w/unload -w läuft auf aktuellem macOS weiterhin, meldet Fehler beim Bootstrap aber nicht auf dieselbe Weise und ist nicht die dokumentierte Schnittstelle; in neuen Skripten bootstrap/bootout bevorzugen. Weder bootstrap noch bootout erfordert einen Neustart, damit die Änderung wirksam wird.