Installer l'agent sur macOS
L'agent macOS sauvegarde un Mac au niveau fichier, via un instantané local APFS du volume : deux prérequis en découlent, un volume source APFS et l'accès complet au disque.
Mis à jour le 23 juillet 2026
Prérequis
Le volume source doit être formaté en APFS : un volume HFS+ est refusé, l'agent ne peut pas en prendre d'instantané. En plus des droits root nécessaires à l'installation, le démon a besoin de l'accès complet au disque (Full Disk Access) pour monter cet instantané en lecture seule.
Installer et enrôler en une commande
Générer un jeton dans le backoffice
Écran Machines → Ajouter une machine. Le jeton s'affiche en clair une seule fois, avec la commande d'installation déjà prête pour macOS.
Exécuter la commande
Dans un terminal, avec sudo :
curl -fsSL https://get.kryolys.com/install.sh | sudo KRYOLYS_ENROLL_TOKEN=<jeton> shLa commande télécharge le paquet .pkg, écrit la configuration, enrôle la machine et démarre le service, sans autre action. Elle est idempotente : la relancer met le paquet à jour sans réécrire une configuration déjà présente.
Accorder l'accès complet au disque
Ouvrir Réglages Système → Confidentialité et sécurité → Accès complet au disque
Kryolys.app propose un bouton qui ouvre directement ce panneau. Ajoutez kryolys-agent à la liste et activez-le.
Relancer le service
Depuis Kryolys.app, un bouton relance le service après confirmation d'un administrateur (dialogue macOS natif). En ligne de commande, la même relance se fait avec sudo launchctl kickstart -k system/work.shpv.kryolys.agent.
Ce que le paquet installe
Un paquet universel (arm64 et x86_64) posant Kryolys.app, kryolys-agent, kryolys-cli et kryolys-tray dans /Library/Kryolys/, un LaunchDaemon pour le service (work.shpv.kryolys.agent), un LaunchAgent pour l'icône de barre de menus (session utilisateur), la configuration dans /Library/Kryolys/etc/ et les journaux dans /Library/Logs/Kryolys/. Le paquet est signé avec un certificat Developer ID et notarisé par Apple.
Limite : mode fichiers uniquement
Contrairement à Windows et Linux, macOS ne propose pas de sauvegarde au niveau bloc : la capture au niveau bloc demanderait un droit Apple (entitlement) que l'agent n'embarque pas aujourd'hui. L'agent macOS prend un instantané APFS du volume, le monte en lecture seule et pousse l'arborescence de fichiers : c'est une sauvegarde fichier par fichier, pas une image disque restaurable en mode bare-metal.
Mise à jour
L'agent macOS se met à jour automatiquement : il vérifie régulièrement le manifeste signé et installe la nouvelle version sans intervention, jamais pendant une sauvegarde. Vous pouvez aussi réinstaller le paquet .pkg le plus récent avec la même commande d'installation : elle ne ré-enrôle pas une machine déjà enrôlée.
Questions fréquentes
Pourquoi l'agent redémarre-t-il en boucle après l'installation ?
Tant que la machine n'est pas enrôlée, la configuration est incomplète et l'agent sort en erreur au lancement. Le système le relance automatiquement, sans bruit excessif dans les journaux, jusqu'à l'enrôlement.
L'agent peut-il restaurer une image disque complète sur Mac ?
Non : macOS étant en mode fichiers, la restauration récupère des fichiers et des dossiers, pas une image disque entière. Voir le guide Restaurer une sauvegarde.