Comment installer FreeSurfer 8.2 sur un Mac Apple Silicon : guide 2026

Le terminal accepte FreeSurfer, mais Freeview reste vide ou SynthSeg échoue sur un Mac Apple Silicon.

La solution la plus rapide consiste à utiliser l’installeur arm64 officiel de FreeSurfer 8.2, à configurer séparément la licence et XQuartz, puis à valider la ligne de commande, Freeview et SynthSeg avec des données de test avant tout sujet réel. Cette procédure évite de confondre « installation terminée » et « environnement de recherche validé ».

Dernière mise à jour le 30 août 2026. Les informations ont été vérifiées à partir des pages officielles de téléchargement, des notes de version FreeSurfer 8.2, de la documentation d’installation Mac et de la documentation XQuartz. Les noms de fichiers et les valeurs affichées dans le tableau de téléchargement doivent être revérifiés le jour de l’installation.

[ SECTION_01 ] Pour quels profils de recherche

Ce guide vise les étudiants en master, doctorants et chercheurs qui doivent établir FreeSurfer 8.2 sur un Mac Apple Silicon.

Il concerne également les équipes dont l’infrastructure repose sur Windows, Linux ou un cluster universitaire, mais qui doivent ajouter une validation macOS à leur flux d’analyse IRM.

Les personnels de support informatique universitaire y trouveront surtout une méthode de réception : version, licence, journaux, affichage, correctifs et reproductibilité doivent être consignés avant d’autoriser un usage scientifique.

La décision ne porte donc pas uniquement sur le téléchargement. Elle porte sur le périmètre réellement nécessaire :

• consultation graphique de volumes et de surfaces ;
• exécution de recon-all sur des sujets anonymisés ;
• utilisation des outils Python et de SynthSeg ;
• reproduction d’un résultat obtenu sous Linux ;
• exécution temporaire sur un Mac distant lorsque le laboratoire ne possède aucun Mac.

[ SECTION_02 ] Le choix arm64 et ses limites

La documentation officielle indique que FreeSurfer 8.2.0 est la version stable actuelle à la date de référence de cet article et qu’une voie arm64 est proposée pour les Mac Apple Silicon. La page de téléchargement doit rester la source principale, car les libellés de version, les noms de fichiers et le tableau des systèmes pris en charge peuvent évoluer ou ne pas être parfaitement synchronisés.

Consultez d’abord la page officielle de téléchargement de FreeSurfer, puis comparez le paquet proposé avec les notes de version FreeSurfer 8.2.0. La présence d’un fichier arm64 n’autorise pas à déduire que chaque composant scientifique fonctionne sans réserve.

Le périmètre doit être séparé ainsi :

• Commande et environnement : l’objectif est de confirmer que les outils FreeSurfer se lancent avec la bonne architecture.
• Recon-all : l’objectif est de vérifier un traitement complet, ses sorties et ses journaux.
• Freeview : l’objectif est de valider la chaîne graphique, notamment XQuartz et une connexion distante éventuelle.
• SynthSeg : l’objectif est de traiter une image et de produire des sorties visualisables après application du correctif officiel.
• Reproduction : l’objectif est de comparer une exécution macOS avec le protocole Linux sans promettre des résultats identiques par principe.

Les notes générales de publication FreeSurfer doivent être relues lorsqu’un laboratoire migre un projet existant. Une procédure qui fonctionnait sur un ancien Mac Intel, dans une machine virtuelle ou sous une version différente de macOS, ne constitue pas une procédure de référence pour Apple Silicon.

[ SECTION_03 ] Comparatif des routes d’environnement

Le tableau suivant sert de décision rapide. Il ne remplace pas une validation sur données représentatives.

Route	Tâche adaptée	Avantage principal	Risque à contrôler	Décision recommandée
Mac Apple Silicon local	Travail régulier avec accès graphique et fichiers locaux	Contrôle direct du système et de l’affichage	Maintenance, version macOS et sauvegardes	À retenir si le laboratoire doit maintenir l’environnement
Mac Apple Silicon distant	Reproduction ponctuelle, complément de cluster, vérification Freeview	Pas d’achat de machine et accès à un macOS complet	Latence VNC, transfert de gros fichiers et continuité de session	À retenir pour une validation ou un besoin limité dans le temps
Linux existant	Production déjà stabilisée sous Linux	Continuité du pipeline et des scripts	Absence de validation macOS	À conserver comme référence lorsque les résultats sont déjà approuvés
Double environnement Linux/macOS	Comparaison de plateformes ou distribution multiplateforme	Séparation entre production et contrôle de compatibilité	Divergences de versions, paramètres et sorties	À retenir si la comparaison influence une publication

Pour une simple inspection d’images, macOS peut être validé rapidement. Pour recon-all, il faut une exécution complète. Pour SynthSeg, il faut une vérification spécifique : le succès de recon-all ne prouve pas que les dépendances Python et le modèle sont utilisables.

[ SECTION_04 ] Installation isolée et licence

Avant toute commande, recensez l’environnement existant. Une ancienne installation FreeSurfer peut être appelée par le profil du terminal, par un script de laboratoire ou par une variable persistante. Installer une nouvelle version par-dessus peut modifier les commandes utilisées par un projet en cours.

La procédure de préparation est la suivante :

1. Notez la version FreeSurfer actuellement appelée, le chemin de FREESURFER_HOME, la valeur de SUBJECTS_DIR et le système d’exploitation.
2. Conservez l’ancien répertoire sans le supprimer. Pour un projet de publication, créez une copie en lecture seule ou une archive contrôlée.
3. Vérifiez que les données de travail et les sorties ne se trouvent pas dans le répertoire qui recevra la nouvelle installation.
4. Téléchargez uniquement le paquet arm64 depuis la page officielle. Contrôlez le nom, la version et la valeur de hachage affichés au moment du téléchargement.
5. Utilisez l’installeur PKG officiel, puis préparez l’initialisation de l’environnement avec la documentation d’installation de FreeSurfer sur Mac.

L’initialisation minimale doit rendre cohérentes trois notions : le répertoire d’installation, le fichier de licence et le projet scientifique. Un exemple de chargement de l’environnement peut prendre la forme suivante :

export FREESURFER_HOME="/chemin/vers/freesurfer"
source "$FREESURFER_HOME/SetUpFreeSurfer.sh"
export FS_LICENSE="/chemin/vers/license.txt"

Les chemins doivent être remplacés par ceux de la machine. Il ne faut pas copier ce bloc dans un profil permanent avant d’avoir identifié l’installation réellement utilisée. Le fichier license.txt doit être conservé avec des permissions adaptées et ne doit pas être confondu avec un simple fichier de configuration.

La page officielle d’enregistrement FreeSurfer reste la référence pour obtenir la licence. L’installation n’est considérée comme fonctionnelle que lorsque la commande de version, le chemin de l’exécutable et la reconnaissance de la licence sont tous confirmés.

[ SECTION_05 ] Validation de la ligne de commande

Cette scène concerne les chercheurs qui veulent lancer des outils FreeSurfer sans interface graphique, notamment depuis Terminal, SSH ou une tâche automatisée.

La validation doit produire des preuves conservables :

• architecture du Mac confirmée par le système ;
• version FreeSurfer affichée par la commande ;
• chemin réel de l’exécutable identifié ;
• licence reconnue sans message d’erreur ;
• lecture réussie d’un échantillon officiel ou anonymisé ;
• code de sortie et journal enregistrés.

La documentation officielle du tutoriel recon-all fournit les commandes et les données de référence à employer. Il est préférable de suivre ce test avant de modifier un script de laboratoire. Un script qui s’exécute dans le mauvais environnement peut donner une impression de réussite tout en appelant une autre version.

Le test doit être arrêté si la commande utilise un ancien chemin, si FS_LICENSE n’est pas reconnu, si SUBJECTS_DIR n’est pas accessible en écriture ou si les journaux ne permettent pas de distinguer une fin normale d’une interruption. Dans ces cas, le retour à l’ancien environnement documenté est plus sûr qu’une correction improvisée pendant une analyse de thèse.

[ SECTION_06 ] Validation de recon-all par scénario

recon-all doit être évalué comme un traitement scientifique continu, et non comme une commande qui « démarre ». La documentation officielle du flux de reconstruction doit servir de base au test.

Le protocole de réception peut suivre cette séquence :

1. Préparez un répertoire de travail séparé, avec une donnée officielle ou un volume anonymisé.
2. Vérifiez les droits de lecture sur l’entrée et les droits d’écriture sur SUBJECTS_DIR.
3. Lancez le traitement avec les paramètres prévus par le protocole, sans utiliser immédiatement l’unique donnée réelle d’un participant.
4. Surveillez le journal jusqu’à la fin effective. Un terminal resté ouvert ne constitue pas une preuve de réussite.
5. Contrôlez le code de sortie, les répertoires produits et les fichiers essentiels attendus par le tutoriel.
6. Comparez visuellement une sortie avec Freeview, puis examinez la qualité sur un sujet représentatif.
7. Conservez la commande exacte, la version, le système, le journal et le résultat du contrôle manuel.

Les ressources de calcul doivent être vérifiées à partir des exigences et recommandations officielles applicables à la version installée. Il ne faut pas inventer une quantité fixe de mémoire, de stockage ou de temps d’exécution à partir d’un seul essai. FreeSurfer 8.x a fait évoluer certains comportements et besoins ; un traitement qui se lance ne prouve pas qu’il terminera de façon stable sur toute une cohorte.

Le test doit être suspendu si le stockage disponible devient incertain, si la session distante se ferme avant la fin, si les journaux signalent une erreur répétée ou si les résultats diffèrent sans explication du protocole de référence. La voie Linux peut alors rester la production principale, tandis que le Mac sert uniquement à la validation de compatibilité.

[ SECTION_07 ] Freeview et la chaîne XQuartz

Freeview est un cas distinct. Une commande recon-all correcte n’implique pas qu’une interface graphique fonctionne, et un lancement raté depuis Finder ne suffit pas à déclarer FreeSurfer incompatible.

Installez ou mettez à jour XQuartz à partir de sa page officielle des versions disponibles. Vérifiez ensuite les indications de la version installée, notamment lorsque l’équipe utilise une version mentionnée dans les notes de publication de XQuartz 2.8.6. La version effectivement proposée le jour du test doit être notée dans le dossier du projet.

La réception graphique se fait en quatre paliers :

• démarrer Freeview depuis Terminal et conserver les messages affichés ;
• vérifier qu’une fenêtre vide s’ouvre ;
• charger un volume puis une surface issus du jeu de test ;
• effectuer les rotations, changements de vue et contrôles nécessaires au contrôle qualité.

Sur un Mac distant, ajoutez trois vérifications qui ne relèvent pas de la documentation FreeSurfer : rafraîchissement de l’image VNC, fluidité des manipulations tridimensionnelles et lecture d’un fichier volumineux depuis le répertoire distant. Ces éléments dépendent de la connexion, du protocole et du poste local. Ils ne doivent pas être présentés comme une performance officielle du logiciel.

Lorsque Finder échoue mais que Terminal ouvre Freeview, le problème se situe probablement dans l’association graphique, l’environnement XQuartz ou la session utilisateur. Lorsque la fenêtre s’ouvre mais que les volumes ne se chargent pas, examinez plutôt les chemins, les permissions et le format des données.

[ SECTION_08 ] SynthSeg et les outils Python

SynthSeg doit recevoir une validation indépendante. Les notes de version de FreeSurfer 8.2 signalent un problème connu sur Mac arm64 pouvant empêcher son installation ou son exécution complète. Cette information doit être traitée comme une limite documentée, pas comme un détail secondaire.

Avant le test :

1. relevez la version exacte de FreeSurfer ;
2. consultez les notes 8.2 pour identifier le correctif officiel le plus récent ;
3. appliquez ce correctif avant de remplacer manuellement une dépendance ;
4. préparez une seule image anonymisée ;
5. vérifiez les dépendances du modèle et le répertoire de sortie ;
6. contrôlez le statut de fin et les fichiers générés ;
7. ouvrez le résultat dans Freeview.

Une installation de base qui passe les tests de licence et de recon-all ne permet pas de conclure que SynthSeg est prêt. Si le correctif officiel ne résout pas le blocage, évitez les substitutions Python non documentées dans un projet destiné à être reproduit. Les choix raisonnables sont alors de conserver Linux, de retarder la migration ou de maintenir un environnement double jusqu’à clarification officielle.

[ SECTION_09 ] Validation d’un flux de recherche complet

La dernière scène concerne la livraison d’un résultat, pas seulement l’administration du Mac. Sélectionnez un sujet anonymisé représentatif de l’analyse prévue dans l’article. Il doit permettre de vérifier les paramètres, les fichiers de sortie et le contrôle qualité manuel.

Le dossier de reproductibilité doit contenir :

• la version FreeSurfer et la version de macOS ;
• l’architecture Apple Silicon ;
• la commande exacte et ses paramètres ;
• les journaux de traitement ;
• les fichiers de sortie utilisés dans l’analyse ;
• les étapes de visualisation dans Freeview ;
• les anomalies constatées et leur résolution ;
• la décision concernant Linux, macOS ou le fonctionnement en double.

Une comparaison Linux/macOS ne doit pas promettre une identité automatique des résultats. Le système d’exploitation, les bibliothèques, les versions et les paramètres peuvent modifier le comportement d’un flux. Avant de mélanger des résultats, l’équipe doit vérifier la documentation de version et l’impact statistique dans le plan d’analyse.

Pour une équipe sans Mac, un environnement Apple Silicon distant peut servir à installer FreeSurfer, traiter un échantillon, vérifier Freeview et récupérer les fichiers. La durée d’utilisation doit ensuite être déterminée par le calendrier du projet et la fréquence des analyses, non par la seule réussite de l’installation. Les offres de Mac Apple Silicon à distance de NOVAKVM peuvent être examinées dans ce cadre, après définition des besoins de connexion, de stockage et de transfert.

[ SECTION_10 ] Décision finale pour le laboratoire

L’achat d’un Mac local est cohérent lorsque l’équipe doit maintenir FreeSurfer pendant une longue période, manipuler régulièrement de gros volumes et contrôler directement les périphériques ou les sauvegardes. En revanche, il impose l’achat, les mises à jour, la maintenance et la conservation d’une configuration stable.

Le serveur Linux reste préférable si recon-all est déjà validé, si les scripts dépendent de l’infrastructure du cluster ou si le Mac ne sert qu’à une vérification occasionnelle. Il ne couvre cependant pas la validation macOS ni certains tests graphiques propres à Freeview.

La location d’un Mac distant devient plus rationnelle pour une migration courte, une reproduction avant soumission, une vérification de compatibilité Apple Silicon ou une période où le laboratoire ne possède aucun Mac. Elle évite de financer immédiatement une machine qui ne sera utilisée que pour quelques contrôles, mais elle ajoute la latence VNC, le transfert des données et la nécessité de documenter la persistance des sessions.

Ainsi, le Mac n’a pas à remplacer le serveur Linux par principe. Une installation FreeSurfer 8.2 correctement isolée, testée sur données anonymisées et complétée par une vérification de Freeview et SynthSeg permet de décider avec des preuves. Pour comparer une configuration locale et une solution distante, les options de Mac mini disponibles chez NOVAKVM donnent un point de départ concret sans confondre matériel, accès distant et validation scientifique.

Si la solution actuelle repose uniquement sur un cluster Linux, elle peut manquer de validation macOS, de contrôle graphique Freeview et d’un environnement Apple Silicon reproductible. Si elle repose sur une machine personnelle, elle peut immobiliser un budget, dépendre d’une configuration unique et compliquer l’accès des autres membres du laboratoire. Pour une reproduction courte, une vérification de compatibilité ou un complément au serveur existant, louer un Mac Apple Silicon auprès de NOVAKVM offre un environnement macOS complet à utiliser pendant la période réellement nécessaire, avant de décider s’il faut acheter, prolonger la location ou conserver un fonctionnement Linux/macOS en parallèle.