|
Size: 2743
Comment:
|
Size: 3927
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| <<TableOfContents>> | ## page was renamed from QuickInstall |
| Line 3: | Line 3: |
| == FreeSurfer System Requirements == '''Summary of Requirements:'''<<BR>> Operating System: Linux, Mac OS X, Windows (via !VirtualBox)<<BR>> Processor Speed: 2GHz at least<<BR>> RAM: 4GB at least (8GB recommended)<<BR>> Graphics card: 3D with its own graphics memory & accelerated OpenGL drivers<<BR>> Install's Disk space usage: 8.5GB<<BR>> Typical subject size: 370MB<<BR>> Tutorial dataset size: 18GB<<BR>> Other requirements: Matlab (to run FS-FAST) |
= FreeSurfer Download and Install = |
| Line 14: | Line 5: |
| == Download == '''Important:''' It is essential to process all your subjects with the same version of !FreeSurfer, on the same OS platform and vendor, and to be completely safe, even the same version of the OS. |
=== Latest Version 7 Release is 7.4.1 (June 2023) === |
| Line 17: | Line 7: |
| == Freesurfer 5.3 stable release == Please refer to the ReleaseNotes page for per-release information. |
Public links to the Freesurfer v7 release downloads and installation instructions are on the release 7 downloads page [[rel7downloads|7.X_releases]]. Please note that Linux RPM/DEB and MacOS installer packages are available. We also provide a [[attachment:installFS_demo.mp4|step-by-step installation demo video]] for MacOS. |
| Line 20: | Line 9: |
| ||'''OS''' || '''Platform''' || '''Version''' || '''Release Date''' || '''Download''' || '''Size''' || || Linux || CentOS 6 x86_64 (64b)|| stable v5.3.0 ||15 May 2013 || [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Linux-centos6_x86_64-stable-pub-v5.3.0.tar.gz|freesurfer-Linux-centos6_x86_64-stable-pub-v5.3.0.tar.gz]]||4.2G|| || Linux || CentOS 4 x86_64 (64b)|| stable v5.3.0 ||15 May 2013 || [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Linux-centos4_x86_64-stable-pub-v5.3.0.tar.gz|freesurfer-Linux-centos4_x86_64-stable-pub-v5.3.0.tar.gz]]||4.0G|| || Linux || CentOS 4 (32b)|| stable v5.3.0 ||15 May 2013|| [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Linux-centos4-stable-pub-v5.3.0.tar.gz|freesurfer-Linux-centos4-stable-pub-v5.3.0.tar.gz]]|| 3.8G || || Mac || Lion OX X 10.7 (64b Intel) || stable v5.3.0 || 15 May 2013 || [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Darwin-lion-stable-pub-v5.3.0.dmg|freesurfer-Darwin-lion-stable-pub-v5.3.0.dmg]] || 3.5G || || Mac || !SnowLeopard OS X 10.6 (32b Intel) || stable v5.3.0 || 15 May 2013 || [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Darwin-snowleopard-i686-stable-pub-v5.3.0.dmg|freesurfer-Darwin-snowleopard-i686-stable-pub-v5.3.0.dmg]] || 3.2G || || Virtualbox || Xubuntu 12.04 || stable v5.3.0 || 15 Aug 2013 || [[ftp://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/5.3.0/freesurfer-Virtualbox-linux-x86-stable-pub-v5.3-full.vdi.gz|freesurfer-Virtualbox-linux-x86-stable-pub-v5.3-full.vdi.gz]] || 9.0G || |
If you have not yet upgraded to Freesurfer version 7, you can read about and compare versions 7 and 6 in the ReleaseNotes. |
| Line 28: | Line 11: |
| == Installation == Please select the instructions for the type you downloaded (and be sure to come back to this page afterwards): * [[LinuxInstall|Linux Installation]] |
Martinos users should visit InternalFreeSurferDistributions for instructions on how to use pre-installed !FreeSurfer distributions. |
| Line 32: | Line 13: |
| * [[MacOsInstall|Mac OS X Installation]] | Freesurfer is also available pre-installed in a VM (virtual machine) image hosted by the open source [[https://www.virtualbox.org/|Virtual Box]] application from Oracle systems. Virtual Box VM's run on most any Windows, Mac and Linux machine powered by Intel processors. The Virtual Box image can be downloaded from [[rel7downloads|Freesurfer 7.X releases]] and instructions to setup the VM are under [[https://surfer.nmr.mgh.harvard.edu/fswiki/VM_67 | Freesurfer VirtualBox]]. For a less portable, i.e., Windows only, setup see the instructions to install and run Freesurfer on Ubuntu Linux using the Windows Subsystem for Linux [[https://surfer.nmr.mgh.harvard.edu/fswiki/FS7_wsl_ubuntu|Freesurfer WSL2]] Please note that WSL2 requires an additional install of a 3rd party X-server on the Windows host in order to view images in Freeview (which is not needed when using Virtual Box).<<BR>> |
| Line 34: | Line 16: |
| * [[Installation/FreeSurferVirtualImage|FreeSurfer Virtual Image Installation using VirtualBox]] | === Previous Version 6 Release (Jan 2017) === Freesurfer v6 release downloads and installation instructions are [[rel6downloads|here]]. '''''Important Note:''' When processing a group of subjects for your study, it is essential to process all your subjects with the same version of !FreeSurfer, on the same OS platform and vendor, and for safety, even the same version of the OS. While we continue to work to ensure that results match across platforms, there are none-the-less system-level libraries that are OS dependent. An exception to this rule is that you may view and edit files across any platform or version, and run some post-processing tools (outside the recon-all stream) if you check with us first (for instance you may run the longitudinal processing with newer versions).'' === Other Versions === '''Development Version:''' Daily builds of the !FreeSurfer development branch can be downloaded from [[https://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer/dev|here]]. '''Older Releases:''' Previous releases of !FreeSurfer can be downloaded from [[https://surfer.nmr.mgh.harvard.edu/pub/dist/freesurfer|here]]. '''Freeview:''' For instructions on how to update Freeview, !FreeSurfer's visualization app, visit the following page: [[UpdateFreeview|Updating Freeview]]. == License == A license key must be obtained to make the !FreeSurfer tools operational. Obtaining a license is free and comes in the form of a license.txt file. Once you obtain the license.txt key file, copy it to your !FreeSurfer installation directory. This is also the location defined by the '''{{{FREESURFER_HOME}}}''' environment variable. [[https://surfer.nmr.mgh.harvard.edu/registration.html|Follow this link to obtain a license key.]] == Additional Resources == [[https://surfer.nmr.mgh.harvard.edu/fswiki/Tutorials|Try our tutorials]] [[https://surfer.nmr.mgh.harvard.edu/fswiki/CourseDescription|Sign up for a FreeSurfer course]] [[https://surfer.nmr.mgh.harvard.edu/fswiki/FreeSurferSupport|Join the FreeSurfer mailing list, ask a question, or view the archives]] {{attachment:openneuro_badge.svg}} A free and open platform that can be used to run !FreeSurfer. For more information, [[https://surfer.nmr.mgh.harvard.edu/fswiki/OpenNeuro|click here]]. |
FreeSurfer Download and Install
Latest Version 7 Release is 7.4.1 (June 2023)
Public links to the Freesurfer v7 release downloads and installation instructions are on the release 7 downloads page 7.X_releases. Please note that Linux RPM/DEB and MacOS installer packages are available. We also provide a step-by-step installation demo video for MacOS.
If you have not yet upgraded to Freesurfer version 7, you can read about and compare versions 7 and 6 in the ReleaseNotes.
Martinos users should visit InternalFreeSurferDistributions for instructions on how to use pre-installed FreeSurfer distributions.
Freesurfer is also available pre-installed in a VM (virtual machine) image hosted by the open source Virtual Box application from Oracle systems. Virtual Box VM's run on most any Windows, Mac and Linux machine powered by Intel processors. The Virtual Box image can be downloaded from Freesurfer 7.X releases and instructions to setup the VM are under Freesurfer VirtualBox. For a less portable, i.e., Windows only, setup see the instructions to install and run Freesurfer on Ubuntu Linux using the Windows Subsystem for Linux Freesurfer WSL2 Please note that WSL2 requires an additional install of a 3rd party X-server on the Windows host in order to view images in Freeview (which is not needed when using Virtual Box).
Previous Version 6 Release (Jan 2017)
Freesurfer v6 release downloads and installation instructions are here.
Important Note: When processing a group of subjects for your study, it is essential to process all your subjects with the same version of FreeSurfer, on the same OS platform and vendor, and for safety, even the same version of the OS. While we continue to work to ensure that results match across platforms, there are none-the-less system-level libraries that are OS dependent. An exception to this rule is that you may view and edit files across any platform or version, and run some post-processing tools (outside the recon-all stream) if you check with us first (for instance you may run the longitudinal processing with newer versions).
Other Versions
Development Version: Daily builds of the FreeSurfer development branch can be downloaded from here.
Older Releases: Previous releases of FreeSurfer can be downloaded from here.
Freeview: For instructions on how to update Freeview, FreeSurfer's visualization app, visit the following page: Updating Freeview.
License
A license key must be obtained to make the FreeSurfer tools operational. Obtaining a license is free and comes in the form of a license.txt file. Once you obtain the license.txt key file, copy it to your FreeSurfer installation directory. This is also the location defined by the FREESURFER_HOME environment variable.
Follow this link to obtain a license key.
Additional Resources
Sign up for a FreeSurfer course
Join the FreeSurfer mailing list, ask a question, or view the archives
A free and open platform that can be used to run FreeSurfer. For more information, click here.