[wiki:FreeSurferWiki top] | [wiki:Download previous] | [wiki:Configuration next]

FreeSurfer Installation


Linux Installation


Mac OS X Installation




INSTALL file for FreeSurfer distribution

Send questions/comments to

FreeSurfer is copyright (c) CorTechs, 1999. All rights reserved.

FreeSurfer is being distributed with executables for Linux/Intel, Darwin/Mac OS X, and SunOS. This is an alpha release and has not been extensively tested. The software is offered "as is" without any guarantees and should not be used for clinical applications. See license.freesurfer for additional restrictions. See docs/license.afni for restrictions on and citations for the use of the AFNI software package and how to cite it. See docs/license.minc for restrictions on and citations for the use of the MINC software package.

Note: These instructions are for installing a new distribution of FreeSurfer. If you want to update an existing FreeSurfer distribution, you should download the snapshot update version from:

Instructions for updating an existing installation are at FreeSurferUpdate.

To configure FreeSurfer

1. Copy the license file into freesurfer/ and rename it to ".license" (no quotes) if necessary.

2. The file freesurfer/FreeSurferEnv.csh is a csh (c-shell) script that will configure your environment so that you can use FreeSurfer. It sets a few envrionment variables and performs some sanity checks. If you are comfortable writing shell scripts, you may wish to set up your system differently, but we recommend the following:

Create a file in your home directory called something like "SetUpFreeSurfer.csh" with the following contents:



The full path to your freesurfer directory should be something like:

2. If you wish to designate a non-default subjects directory, add the following line in the 'additional configurations' section, before 'cd $FREESURFER_HOME' is called:

3. If you installed the MINC tools, then add the following lines to the additional configuration section:

If you did not install the MINC tools, then add the following line in the local setup section:

4. If you do NOT intend to use the functional tools, then add the following line to the additional configuration section:

If you do intend to use the functional tools, then add these lines to your ~/matlab/startup.m file:

5. Save the file. You will need to source this file every time you want to use Freesurfer.

6. Make sure you are using csh or tcsh. You can check by typing 'ps' at the command line. If you do not see csh or tcsh as one of the processes in the right hand column of output, you must change your default shell to csh or tcsh or explicitly launch csh or tcsh first.

To explicitly launch csh or tcsh (tcsh is recommended), simply enter the following command:

You may notice your prompt change. Note that some of your login files may not be run in the new shell environment. See the man pages for tcsh for details.

7. Source the script.

You should see output like this:

If you see any warnings, you can probably safely ignore them, but make sure they are not notifying you that it can't find something you think should exist.

If you see any error messages, make sure you have performed the installation process properly, and that your FREESURFER_HOME setting is correct.

From now on, you only need to source the SetUpFreeSurfer.csh script once in a shell session to be able to run FreeSurfer. You may want to do this in our shell's login scripts (i.e. .cshrc or .tcshrc).

To use FreeSurfer

See $FREESURFER_HOME/docs/FreeSurferManual.pdf to get started. See also See also recon-all -help

Mac OS X Notes

1. You may need to use the OS X minc 1.2 available from the MNI website. There are bugs in it, but MNI has promised a fix soon.

2. You should use fink to install the additional libraries that FreeSurfer needs, such as libtiff and libdl. You can get fink from:

Once you've installed fink, there are two packages you'll need to install:

FTP File Exchange

Use ftp Login as anonymous and password as "email-address".

Connected to (
220 FTP server (Version wu-2.6.2-11.73.1) ready.
Name ( anonymous
331 Guest login ok, send your complete e-mail address as password.
230 Guest login ok, access restrictions apply.
Remote system type is UNIX.
Using binary mode to transfer files.

If you are getting files, then 

   ftp> cd transfer/outgoing

If you are putting files, then

   ftp> cd transfer/incoming

Then go to a particular directory.

For those inside NMR center, go to /space/outgoing and put files in its subdirectory. You can get user transfered files from /space/incoming. It takes 5 minutes or so to actually see the files there after the transfer.