Vai al contenuto
GLGiuseppe Lanza Scrivimi

Servizi in background su macOS con launchctl

Come funziona launchd, LaunchAgents e LaunchDaemons, i comandi moderni di launchctl, un LaunchAgent che esegue uno script ogni ora e cosa disattivare con prudenza.

Sistemi: macOS 13 Ventura – 26 Tahoe · Apple Silicon e IntelLivello: IntermedioTempo: 40 minutiAggiornata: novembre 2026

launchd, il primo processo del Mac

Sul Mac non c’è init, non c’è systemd e cron è ancora presente ma deprecato: tutto passa da launchd, il processo con PID 1. All’avvio è lui che fa partire i servizi di sistema, al login quelli dell’utente; li riavvia se terminano, li lancia a orari stabiliti o quando succede qualcosa (un file che cambia, una connessione su una porta, un volume montato). In pratica fa il lavoro che su Linux si dividono systemd, cron e inetd.

Ogni servizio è descritto da un file plist (XML) con un’etichetta univoca, la Label, in stile dominio rovesciato: com.apple.cloudphotod, com.microsoft.update.agent, it.esempio.controllo-disco. Il comando per parlare con launchd è launchctl.

Chi ha letto la mia vecchia guida Pianificare le attività con cron ritroverà gli stessi concetti con un’altra sintassi: al posto della riga del crontab c’è un plist, al posto di crontab -e c’è launchctl bootstrap.

LaunchAgents e LaunchDaemons

La distinzione più importante è tra due tipi di servizio:

  • un LaunchDaemon gira per conto del sistema, di solito come root, parte all’avvio anche se nessuno ha fatto login e non può mostrare nulla a schermo;
  • un LaunchAgent gira per conto di un utente, parte al suo login, vive nella sua sessione grafica e può usare le sue cartelle, il suo portachiavi, le notifiche.
launchd PID 1 Dominio system LaunchDaemons · root · all’avvio Dominio gui/501 LaunchAgents · utente · al login /Library/LaunchDaemons/*.plist ~/Library/LaunchAgents/*.plist Un agente vive nella sessione dell’utente, un demone parte con il sistema
launchd tiene i servizi in domini separati: system per i demoni, gui/UID per gli agenti di ciascun utente collegato (501 è l’UID del primo utente creato sul Mac).

I plist stanno in tre gruppi di cartelle. Tabella 1 – Dove si trovano:

CartellaTipoDi chi è
/System/Library/LaunchDaemonsDemoniApple. Volume di sistema in sola lettura, protetto da SIP
/System/Library/LaunchAgentsAgenti, per tutti gli utentiApple. Protetto da SIP
/Library/LaunchDaemonsDemoniSoftware di terze parti installato dall’amministratore (antivirus, VPN, agenti di gestione)
/Library/LaunchAgentsAgenti, per tutti gli utentiSoftware di terze parti
~/Library/LaunchAgentsAgenti, solo per quell’utenteL’utente: è qui che mettiamo i nostri

Le app moderne possono anche registrare i loro servizi da dentro il pacchetto .app (in Contents/Library/LaunchAgents o LaunchDaemons), senza copiare file in queste cartelle: per questo non tutto quello che gira compare negli elenchi qui sopra.

Gli elementi di login nelle Impostazioni

Da Ventura c’è un pannello grafico che riassume cosa parte da solo. Aprite Impostazioni di Sistema → Generali → Elementi login (su macOS 15 e 26 si chiama Elementi login ed estensioni). Troviamo due parti:

  • Apri al login: le app che si aprono quando entriamo nell’account. Si aggiungono e si tolgono con + e −.
  • La sezione dei servizi in background (su Ventura e Sonoma «Consenti in background»; su Tahoe la troviamo come «Attività app in background»): un interruttore per ogni app o produttore che ha registrato agenti o demoni.

Spegnere un interruttore impedisce a launchd di avviare i servizi di quel produttore, senza cancellare nulla: se l’app poi non funziona bene, lo riaccendiamo. È il modo più sicuro per fare pulizia, e il primo da provare prima di arrivare al Terminale. Quando un programma (o noi stessi) aggiunge un nuovo servizio, macOS mostra una notifica che segnala il nuovo elemento in background: vale la pena leggerla, perché è anche il modo in cui ci accorgiamo di software installato a nostra insaputa.

Lo stesso elenco, con il percorso esatto di ogni plist, lo otteniamo dal Terminale:

sudo sfltool dumpbtm | less     # elenco completo degli elementi in background registrati

Cosa sta girando

Come faccio a sapere se un certo servizio è attivo? Il comando più rapido è quello di sempre:

launchctl list | grep -i microsoft
PID     Status  Label
812     0       com.microsoft.update.agent
-       0       com.microsoft.autoupdate.helper

La prima colonna è il PID (un trattino se in quel momento non è in esecuzione), la seconda il codice d’uscita dell’ultima esecuzione: 0 è tutto bene, un numero positivo è un errore del programma, un numero negativo indica che è stato terminato da un segnale (-9 = SIGKILL). Lanciato senza sudo, launchctl list mostra gli agenti del nostro utente; con sudo mostra i demoni di sistema.

Per i dettagli di un singolo servizio usiamo print, indicando il dominio:

# un agente del nostro utente
launchctl print gui/$(id -u)/com.apple.cloudphotod

# un demone di sistema
sudo launchctl print system/com.openssh.sshd

# tutto il dominio (lungo: meglio filtrare)
launchctl print gui/$(id -u) | less

Nell’output cerchiamo le righe path (il plist), program o arguments (cosa esegue), state (running o not running), runs (quante volte è partito) e last exit code. Altri due comandi utili:

launchctl blame gui/$(id -u)/com.apple.cloudphotod   # perché è in esecuzione adesso
launchctl print-disabled gui/$(id -u)                # servizi disattivati per il nostro utente
sudo launchctl print-disabled system                 # e per il sistema

I comandi di launchctl: vecchi e nuovi

Su molte guide in rete troviamo ancora launchctl load e unload. Funzionano ancora, ma Apple li considera superati (l’aiuto di launchctl suggerisce già le alternative) e su alcuni servizi danno errori poco chiari. La sintassi moderna richiede di indicare il dominio, ed è più precisa. Tabella 2 – Corrispondenze:

Cosa vogliamoSintassi modernaVecchia sintassi
Caricare un servizio (e avviarlo se previsto)launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/x.plistlaunchctl load x.plist
Scaricarlo (e fermarlo)launchctl bootout gui/$(id -u)/it.esempio.xlaunchctl unload x.plist
Disattivarlo in modo permanentelaunchctl disable gui/$(id -u)/it.esempio.xlaunchctl unload -w x.plist
Riattivarlolaunchctl enable gui/$(id -u)/it.esempio.xlaunchctl load -w x.plist
Avviarlo subitolaunchctl kickstart gui/$(id -u)/it.esempio.xlaunchctl start it.esempio.x
Riavviarlo (termina e riparte)launchctl kickstart -k gui/$(id -u)/it.esempio.xstop e poi start
Inviargli un segnalelaunchctl kill SIGTERM gui/$(id -u)/it.esempio.xkill sul PID

Per i demoni il dominio è system e serve sudo: sudo launchctl bootstrap system /Library/LaunchDaemons/x.plist, sudo launchctl kickstart -k system/it.esempio.x.

Disable non ferma, bootout non è per sempre

disable e enable scrivono in un registro che sopravvive ai riavvii, ma non fermano un processo già in esecuzione: dicono solo a launchd di non caricarlo più. bootout invece ferma e scarica subito, ma al login o all’avvio successivo il servizio torna. Per spegnere qualcosa adesso e per sempre servono tutti e due: prima disable, poi bootout.

Un nostro LaunchAgent, passo per passo

Vediamo un caso concreto: uno script che ogni ora controlla lo spazio libero del disco di avvio, scrive una riga di log e ci avvisa con una notifica se si scende sotto il 10%. È un agente (gira come noi, al nostro login), quindi va in ~/Library/LaunchAgents. Negli esempi l’utente è utente: sostituitelo con il vostro nome breve (whoami).

Lo script

Per prima cosa creiamo la cartella e lo script:

mkdir -p ~/bin ~/Library/Logs
nano ~/bin/controllo-disco.sh
~/bin/controllo-disco.sh
#!/bin/zsh
# controlla lo spazio libero del volume dati e avvisa sotto la soglia
SOGLIA=10   # percentuale minima di spazio libero

# su APFS lo spazio dell’utente è nel volume dati
uso=$(df -P /System/Volumes/Data | awk 'NR==2 { sub("%","",$5); print $5 }')
libero=$(( 100 - uso ))

echo "$(date '+%Y-%m-%d %H:%M:%S') libero ${libero}%"

if (( libero < SOGLIA )); then
    osascript -e "display notification \"Spazio libero: ${libero}%\" with title \"Disco quasi pieno\""
fi
chmod 755 ~/bin/controllo-disco.sh
~/bin/controllo-disco.sh          # proviamolo a mano prima di automatizzarlo

Il plist

~/Library/LaunchAgents/it.esempio.controllo-disco.plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>it.esempio.controllo-disco</string>

    <key>ProgramArguments</key>
    <array>
        <string>/bin/zsh</string>
        <string>/Users/utente/bin/controllo-disco.sh</string>
    </array>

    <!-- ogni 3600 secondi, e una volta subito al caricamento -->
    <key>StartInterval</key>
    <integer>3600</integer>
    <key>RunAtLoad</key>
    <true/>

    <key>StandardOutPath</key>
    <string>/Users/utente/Library/Logs/controllo-disco.log</string>
    <key>StandardErrorPath</key>
    <string>/Users/utente/Library/Logs/controllo-disco.err</string>
</dict>
</plist>
  • Label deve essere unica e, per abitudine, uguale al nome del file senza .plist.
  • ProgramArguments è il comando spezzato in parole: niente stringa unica con gli spazi, niente ~ (launchd non lo espande), solo percorsi assoluti.
  • StartInterval conta i secondi. Se il Mac dorme quando scade l’intervallo, il lavoro parte una volta sola al risveglio, non tante volte quante ne ha perse. Per un orario preciso (come una riga di cron) si usa invece StartCalendarInterval, per esempio con le chiavi Hour e Minute.
  • StandardOutPath e StandardErrorPath raccolgono quello che lo script scrive a schermo: senza, l’output va perso.
  • Il PATH di launchd è minimo (/usr/bin:/bin:/usr/sbin:/sbin): se lo script usa programmi di Homebrew, scriviamo il percorso completo (/opt/homebrew/bin/…) oppure aggiungiamo la chiave EnvironmentVariables.

Verifica e caricamento

Prima di caricarlo controlliamo la sintassi, che è la causa di errore più frequente:

plutil -lint ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
/Users/utente/Library/LaunchAgents/it.esempio.controllo-disco.plist: OK

Se è ok procediamo, altrimenti plutil indica la riga sbagliata. A questo punto carichiamo l’agente e verifichiamo che giri:

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/it.esempio.controllo-disco.plist
launchctl list | grep controllo-disco
-       0       it.esempio.controllo-disco

launchctl print gui/$(id -u)/it.esempio.controllo-disco | grep -E 'state|runs|last exit'
cat ~/Library/Logs/controllo-disco.log
2026-11-16 10:00:01 libero 41%

Per forzare un’esecuzione senza aspettare un’ora: launchctl kickstart gui/$(id -u)/it.esempio.controllo-disco. Il PID resta un trattino perché lo script dura un istante e termina: è il comportamento corretto.

Modificarlo e toglierlo

# dopo aver cambiato il plist: scarichiamo e ricarichiamo
launchctl bootout gui/$(id -u)/it.esempio.controllo-disco
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/it.esempio.controllo-disco.plist

# per eliminarlo del tutto
launchctl bootout gui/$(id -u)/it.esempio.controllo-disco
rm ~/Library/LaunchAgents/it.esempio.controllo-disco.plist

Le modifiche allo script invece valgono subito, dall’esecuzione successiva: launchd rilegge solo il plist. Un demone si costruisce allo stesso modo, ma il plist va in /Library/LaunchDaemons, deve appartenere a root:wheel con permessi 644, e si carica con sudo launchctl bootstrap system … (consiglio: usate un demone solo se lo script deve davvero girare come root o senza nessuno collegato).

Cosa disattivare, e con quanta prudenza

Il Mac è lento, la ventola gira: posso spegnere qualche servizio? Prima di toccare qualcosa conviene capire chi è. La regola pratica:

  • Servizi di terze parti (com.adobe.*, com.google.*, aggiornatori, «helper» di app che non usiamo più): sono i candidati naturali. Prima spegniamo l’interruttore in Elementi login; se non basta, disable e bootout. Se l’app non ci serve più, disinstalliamola: i suoi plist spesso restano in /Library/LaunchAgents e /Library/LaunchDaemons e vanno cancellati a mano (prima bootout, poi rm).
  • Servizi Apple (com.apple.*): di regola non si toccano. Molti dipendono l’uno dall’altro e disattivarne uno può rompere funzioni in modi difficili da collegare alla causa. I loro plist stanno nel volume di sistema in sola lettura e SIP impedisce di modificarli o di scaricare molti di essi anche con sudo (l’errore tipico è Operation not permitted while System Integrity Protection is engaged).

Il caso di cloudphotod

C’è però un margine: launchctl disable su un servizio Apple del dominio utente di solito è accettato, perché scrive solo nel registro delle preferenze e non tocca i file protetti. Un esempio che mi capita di usare è cloudphotod, il processo che sincronizza la libreria di Foto con iCloud: su un Mac collegato a una rete a consumo o durante un lavoro che richiede tutta la banda, può dare fastidio.

La strada giusta, se la sincronizzazione non serve, è spegnerla dove è nata: app Foto → Impostazioni → iCloud, togliendo «Foto di iCloud». Se invece vogliamo solo fermare il servizio per un periodo, il comando corretto indica il dominio dell’utente (scritto senza dominio, launchctl disable com.apple.cloudphotod dà errore di sintassi):

launchctl print gui/$(id -u)/com.apple.cloudphotod | grep -E 'state|path'   # chi è
launchctl disable gui/$(id -u)/com.apple.cloudphotod
launchctl print-disabled gui/$(id -u) | grep cloudphotod
"com.apple.cloudphotod" => disabled

Come abbiamo visto, disable non ferma il processo già avviato: l’effetto pieno lo abbiamo dopo un logout e un nuovo login, o un riavvio. Per tornare indietro:

launchctl enable gui/$(id -u)/com.apple.cloudphotod

e di nuovo logout e login. Finché il servizio è disattivato la libreria di Foto non si sincronizza: annotiamo da qualche parte cosa abbiamo spento e perché, così fra sei mesi, quando una foto non arriva sull’iPhone, sappiamo dove guardare.

Mai su servizi che non conosciamo

Prima di disattivare un com.apple.* cerchiamo cosa fa, verifichiamo che non esista un’impostazione grafica che ottiene lo stesso risultato e teniamo pronto il comando enable. Non disattiviamo mai servizi legati a sicurezza, aggiornamenti, rete o login (com.apple.xprotect*, com.apple.softwareupdated, com.apple.mDNSResponder, com.apple.loginwindow…). Non ho verificato se ogni aggiornamento di macOS conserva o azzera queste disattivazioni: dopo un aggiornamento controlliamo con print-disabled.

Problemi comuni

SintomoCausa e soluzione
Bootstrap failed: 5: Input/output errorMessaggio generico. Le cause più frequenti: servizio già caricato (prima bootout), plist non valido (plutil -lint), servizio disattivato (print-disabled, poi enable), permessi o proprietario del plist sbagliati, interruttore spento in Elementi login.
L’agente è caricato ma lo script non fa nullaGuardiamo StandardErrorPath e last exit code in launchctl print. Spesso è un comando non trovato per via del PATH ridotto: usiamo percorsi assoluti.
Operation not permitted nel log dello scriptLo script legge una cartella protetta da TCC (Documenti, Scrivania, dischi esterni). Diamo l’accesso completo al disco all’interprete (/bin/zsh) in Privacy e sicurezza, o spostiamo i file altrove.
Codice d’uscita 78 o 126Di solito il programma indicato non è eseguibile o il percorso è sbagliato: controlliamo ProgramArguments e i permessi (chmod 755).
Il servizio parte una sola volta e poi mai piùManca StartInterval o StartCalendarInterval, oppure l’abbiamo scritto con il tipo sbagliato (<string> al posto di <integer>).
Operation not permitted while System Integrity Protection is engagedStiamo cercando di scaricare un servizio Apple protetto. Lasciamolo stare: se proprio serve, valutiamo disable nel dominio corretto, con le cautele viste sopra.

Il passo successivo

Un LaunchAgent è il modo naturale per automatizzare i backup del Mac: lo script con rsync lo trovate in Time Machine, tmutil e backup con rsync, e l’idea di base è la stessa della mia vecchia guida Un semplice backup con rsync. Per le basi del Terminale e di defaults vedi Il Terminale del Mac per sistemisti; per SIP, TCC e le altre protezioni che limitano anche launchctl, Le protezioni di macOS. Chi viene da Linux e vuole confrontare launchd con systemd, la guida Uno script per analizzare i log di Ubuntu mostra lo stesso tipo di automazione con un timer.

Prima di andare in produzione

Prova sempre la configurazione in laboratorio, salva quella attuale prima di modificarla e tieni un accesso di emergenza (console o accesso fuori banda) quando lavori su firewall e VPN da remoto.