FreeSurfer 8.2をApple Silicon Macにインストールする方法：2026年ガイド

Freeviewは起動するのに、recon-allやSynthSegだけが止まる。あるいは、Intel Mac向けの古い手順でインストール先が分からない。

FreeSurfer 8.2はApple Silicon Mac向けのarm64導入ルートを使います。公式パッケージ、ライセンス、XQuartzを個別に設定し、コマンドライン、Freeview、SynthSegを別々に検証してください。実験室にMacがない場合は、まず遠隔のApple Silicon Macで脱​​敏サンプルと代表的な被験者を確認し、その後に購入、継続レンタル、Linuxとの併用を決めるのが安全です。

本記事は、Apple Silicon MacでFreeSurfer 8.2を構築したい大学院生、博士課程の研究者向けです。
Windows、Linux、高校・大学のHPC環境を主に使い、macOSでの再現確認が必要な研究者にも適しています。
研究室のバージョン管理、ライセンス管理、結果の再現性を担当する技術職員にも役立つ構成です。

最終更新：2026年8月30日。 FreeSurferの安定版、arm64パッケージ、対応macOS、SynthSegの既知問題は、公開前に公式ダウンロードページ、公式リリースノート、8.2.0更新情報で再確認してください。

[ SECTION_01 ] 最初に分けるべき3つの利用シナリオ

FreeSurferの導入可否は、「インストーラーが完了したか」だけでは判断できません。目的によって必要な確認項目が変わります。

  • コマンドライン解析が目的
    recon-allを使った脳構造の再構成、ログ保存、出力確認が中心です。ライセンス、環境変数、保存先の権限、長時間処理の安定性を確認します。
  • Freeviewで画像や表面を確認する目的
    FreeSurfer本体だけでなく、XQuartz、画面転送、VNCの描画状態を確認します。Finderから開けないだけで、解析機能全体が壊れているとは限りません。
  • SynthSegやPythonツールを使う目的
    基本コマンドが動いても、深層学習系の依存関係まで利用できるとは限りません。FreeSurfer 8.2の更新情報にあるarm64 Macの既知問題を先に確認します。

FreeSurfer 8.2.0は、公式情報上で現在の安定版として案内され、Apple Silicon向けarm64の導入ルートとmacOS Tahoe対応情報が示されています。ただし、ダウンロード表のバージョン表示、ファイル名、対応システム欄に差異が見える場合があるため、検索結果や古いブログではなく、取得当日の公式ページとチェックサムを基準にします。

[ SECTION_02 ] FreeSurfer 8.2 Apple Silicon Mac インストールの分岐点

旧環境を残すか、新しい環境に分けるか

論文作業中のMacに新しいFreeSurferを上書きすると、既存プロジェクトの再現条件が分からなくなる可能性があります。先に旧環境のバージョン、FREESURFER_HOME、ライセンスの保存場所、使用した起動スクリプトを記録し、解析フォルダーは読み取り専用のバックアップとして残します。

既存のIntel Mac向け手順や仮想マシン手順を、そのままApple Silicon Macに移すのは避けます。公式のMac向けインストール文書に沿ってarm64パッケージを選び、旧版とは別の検証用プロジェクトで確認します。

最小インストール手順

  1. ターミナルでCPUアーキテクチャを確認します。

bash uname -m

Apple Silicon環境ではarm64が表示されることを確認します。Rosetta経由のシェルやIntel向けバイナリを使っていないかも確認します。

  1. 公式ダウンロードページから、当日に表示されているarm64用PKGを取得します。ページの版数とファイル名が一致しない場合は、自己判断で名前を補正せず、公式のチェックサムと公開情報を照合します。

  2. PKGをインストールした後、FREESURFER_HOMEを実際の導入先に合わせます。環境初期化スクリプトを読み込み、ターミナルを開き直した後も同じ設定が維持されるか確認します。

  3. FreeSurfer公式の登録ページから取得したlicense.txtを用意します。既存のライセンスを使う場合も、研究室内での利用条件と有効性を確認します。

  4. FS_LICENSEが正しいファイルを指しているか確認します。ライセンスをホームディレクトリ直下に置く方法だけに固定せず、環境変数またはFreeSurferが認識する設定で明示します。

  5. バージョン表示、実行ファイルの場所、ライセンス認識を確認します。たとえば、次のように環境を読み込んでからバージョンを確認します。

bash source "$FREESURFER_HOME/SetUpFreeSurfer.sh" freesurfer

実際の初期化ファイル名や導入先は、当日の公式文書に表示される構成を優先します。

  1. 公式サンプルの読み込みまで完了させます。インストーラーが終了したことではなく、コマンドが実行され、ライセンスが認識され、サンプルにアクセスできることを最小の合格条件にします。

license.txtは、単にダウンロードフォルダーに置くだけでは不十分です。FreeSurferが参照する場所、FS_LICENSEの値、ファイルの読み取り権限を一つずつ確認してください。

[ SECTION_03 ] recon-allは「起動」ではなく連続処理で判定する

Apple Silicon Macでrecon-allを実行する前に、唯一の実データを使ってはいけません。公式チュートリアルのデータ、または研究室で脱​​敏した検証用データを使い、入力画像、出力先、ログの保存場所を分けます。

公式のrecon-allチュートリアルと再構成フローの説明を基準に、次の項目を記録します。

  • SUBJECTS_DIRが意図した保存先を指しているか
  • 入力画像と出力先に読み書き権限があるか
  • 空きストレージが、入力・中間ファイル・最終出力を含めて十分か
  • Macがスリープや自動終了を起こさず、連続処理を維持できるか
  • 終了ステータス、ログ末尾、生成された主要ファイルを確認できるか
  • 同じ条件で再実行した際に、途中状態が原因で処理が混乱しないか

FreeSurfer 8.xでは処理内容や必要リソースの扱いが変わっているため、「コマンドが開始した」ことから長時間の再構成が安定して完了すると推測してはいけません。メモリ、ストレージ、連続稼働のどれかが不足する場合は、対象数を増やさず、旧環境またはLinuxサーバーへ戻します。

Apple Silicon Macでrecon-all前に確認する項目

合格とする条件は、公式サンプルで処理が最後まで進み、ログと出力を第三者が確認できることです。代表的な被験者で途中停止、出力欠落、再実行時の不整合が出た場合は、論文用の本番データへ拡張しません。

Linux環境との結果を混ぜる場合は、OS、FreeSurfer版、コマンド引数、入力データ、処理ログを同じ記録票に残します。異なるOSで得た結果が自動的に完全一致するとは考えず、統計解析計画と公式の版別情報に基づいて比較可否を判断します。

[ SECTION_04 ] FreeviewとXQuartzは表示経路を分けて調べる

FreeviewがMacで開かない場合の確認順

FreeviewをFinderから開けない場合でも、FreeSurferのコマンドライン処理まで失敗したとは限りません。まずターミナルから起動し、空のウィンドウ、体積画像、表面データ、基本的な回転操作を順番に確認します。

XQuartzはFreeviewの表示経路に関係するため、現在の公式リリース情報を確認して導入します。特定版を使う必要がある場合は、XQuartz 2.8.6の公開説明も参照します。Freeviewの異常を、Mac本体の問題、XQuartzの問題、遠隔画面の問題に分けて記録することが重要です。

確認結果は次のように分けます。

  • ウィンドウ自体が出ない：XQuartz、環境変数、起動ログを確認します。
  • ウィンドウは出るが画像が読めない：ファイルパス、権限、データ形式を確認します。
  • 画像は読めるが表面操作で落ちる：表示ドライバーやFreeviewのログを保存します。
  • ローカルでは動くがVNCでは操作できない：遠隔接続の描画更新、三次元操作、大容量ファイルの読み込みを別途確認します。

遠隔Macでは、VNCの画面更新速度や操作感を公式ソフトウェアの性能説明で代用できません。研究室の回線、接続方式、利用時間帯が結果に影響するため、実際の接続経路でFreeviewを操作して判定します。

[ SECTION_05 ] SynthSegは別の合格条件を設ける

FreeSurfer 8.2の基本インストールが成功しても、SynthSegが同じように使えるとは限りません。公式の8.2.0更新情報には、arm64 MacでSynthSegのインストールまたは完了に関する既知問題が記載されているため、先に最新パッチの有無を確認します。

検証は単一の脱​​敏画像から始めます。次の4点を残してください。

  • モデルやPython依存関係が正しく導入されたか
  • 期待する出力ファイルが生成されたか
  • プロセスがエラーなく終了したか
  • Freeviewなどで結果を目視確認できたか

recon-allの成功だけを根拠に、Pythonツール全体を利用可能と判断してはいけません。公式パッチを適用しても重要なモジュールが完了しない場合は、手作業で依存関係を置き換えず、Linux環境を維持するか、MacとLinuxの二系統構成にします。

[ SECTION_06 ] 導入方式を決めるための比較

選択肢 向いている用途 強み 停止・見直し条件 判断
Apple Silicon Macを購入 長期的にmacOS解析を継続し、物理的な周辺機器も使う 環境を固定しやすく、ローカル表示を確認しやすい 維持管理、初期費用、研究終了後の利用計画が不明確 長期利用なら有力
遠隔Apple Silicon Macをレンタル 短期の再現確認、論文用の補助解析、互換性確認 実機を購入せず、必要な期間だけ環境を確保できる 長時間処理やFreeview操作を実経路で確認できない まず試す方式として有力
Linuxサーバーを継続 既存の解析基盤が安定し、macOS固有の確認が不要 既存データや運用を変えずに済む macOS版の再現確認やFreeview検証が必要になった 主経路または退避先
MacとLinuxの二系統 OS差を含めて結果を比較し、研究室で再現性を管理する 片方の既知問題に依存しにくい 版、ログ、入力条件の管理負担が増える 重要な課題では有効

Macの購入判断では、短期の検証だけでなく、卒業後の利用、研究室の管理者、データ保管方針まで考慮します。Apple Silicon環境を一時的に確認したい場合は、NOVAKVMのMac環境案内を候補の一つとして比較できます。

[ SECTION_07 ] 研究成果として放行する前の記録

代表的な脱​​敏被験者を一つ選び、次の記録を一式にします。

  1. FreeSurferの版とインストール日
  2. macOSの版とCPUアーキテクチャ
  3. FREESURFER_HOME、FS_LICENSE、SUBJECTS_DIR
  4. 使用したコマンドと引数
  5. recon-allおよびSynthSegのログ
  6. 主要な出力ファイル
  7. Freeviewによる目視確認
  8. Linux側との比較条件と統計上の扱い

この記録があれば、Macで得た結果を論文や共同研究へ持ち込む際に、環境差を説明できます。Freeviewの確認だけで解析結果の品質を保証することはできないため、画像の人工的な欠損、表面の異常、被験者ごとの除外基準も研究計画に沿って残します。

現行のWindows・Linux中心の構成は、既存のHPC、バッチ処理、共有ストレージを利用できる反面、macOS版の確認、Freeviewの表示経路、Apple Silicon固有のSynthSeg問題を別途抱えます。Macを購入しても、短期課題では初期設定、保守、データ移送が負担になります。短期間の再現確認や論文の補助図作成なら、NOVAKVMの遠隔Apple Silicon Macで公式サンプルと代表的な被験者を先に通し、全工程が完了した後に購入、継続レンタル、Linuxとの二系統運用を選ぶ方が判断を誤りにくいです。

まずは課題の期間と必要な処理だけを切り出し、Apple Silicon Macの導入候補と既存Linux環境を同じ検証記録で比較してください。FreeSurfer 8.2 Apple Silicon Mac インストールの合格条件は、導入完了ではなく、ライセンス認識、recon-all、Freeview、SynthSeg、そして研究成果の再現記録まで確認できることです。

Apple Silicon Macの研究環境をすぐに整えませんか

NOVAKVMなら、Apple Silicon搭載Macを研究用途に合わせてレンタルできます。

実験室に専用のMacがない場合でも、遠隔操作できる環境で導入前の検証を進められます。

料金を見る →