# Installing on Linux/Unix

## The Easy Way

### Running the installer

We provide an installer script to automate the process of installing FSL (or applying a patch), which can be downloaded from this location:

- fsl_installer.sh - Version 1.6 09/02/2012

Place the installer in the same folder as the downloaded FSL distribution tar ball. Then in a terminal window (in Cent OS you can open one of these by right clicking on the Desktop and choosing Open Terminal) change to this folder and run the installer. By example, if you downloaded the installer and the FSL .tar.gz file to your Desktop:

    cd ~/Desktop
    bash fsl_installer.sh

If you are happy with installing FSL into /usr/local then just press Return, to accept the defaults, when the installer asks a question.

Be aware that you may need Administrator priviledges to install into certain folders on your computer - /usr/local being an example. If this is the case, the installer will attempt to gain these priviledges through the use of the sudo command, which will require you to enter your password for verification. If you don't have any rights to use sudo then the installer will fail and will need to be run as the root user. Should you install as root see the configuring your account for FSL section for details on how to use the installer to setup your user account for FSL.

For more information on controlling the installer, run it with the -h option.

### Configuring your account for FSL usage using the install script

In addition to installing the FSL programs, the install script is also capable of configuring your user account to enable you to run the FSL programs. If your user account was used to run the installer when installing the FSL programs, this will have already been done, but you may also want to configure additional accounts. To do this, log in as the user wishing to run FSL and execute the installer with the -e option, eg:

    bash fsl_installer.sh -e

## The Traditional Way

### Checking the download

Visit our checksums page to download the MD5 sum file that matches the .tar.gz package you have downloaded. Make sure that the .md5 file is in the same directory as the .tar.gz file and in a terminal, type:

    md5sum -c name of .md5 file

for example

    md5sum -c fsl-4.1.3-centos5_64.tar.gz.md5

The verification will take a few minutes

### Unpacking

To unpack a distribution, you need the UNIX tar utility. First cd to the directory where you want FSL installed (for example /usr/local). Then uncompress and untar the distribution - for example, if you have downloaded the Cent OS 5 32bit distribution to your home directory, type

    tar zxvf ~/fsl-*-centos5-32.tar.gz

### Configuring

Put the following somewhere in your shell setup file (.bashrc, .profile, .cshrc etc., depending on what shell you use), replacing "/usr/local/fsl" with a path appropriate for where you have installed FSL:

- bash / sh / ksh:

      FSLDIR=/usr/local/fsl
      . ${FSLDIR}/etc/fslconf/fsl.sh
      PATH=${FSLDIR}/bin:${PATH}
      export FSLDIR PATH

- tcsh / csh

      setenv FSLDIR /usr/local/fsl
      source ${FSLDIR}/etc/fslconf/fsl.csh
      setenv PATH ${FSLDIR}/bin:${PATH}

The FSL command line tools are located in $FSLDIR/bin. In general command-line programs are lower case (e.g. bet); the GUI version capitalised (e.g. Bet).

To bring up a simple GUI which is just a menu of the main individual FSL GUI tools, just type fsl.

## Linux System-wide Configuration

If you are administering a multi-user Linux system you can ensure that FSL is configured for all users by creating the files /etc/profile.d/fsl.sh and /etc/profile.d/fsl.csh with the contents specified above. This has been tested on Cent OS 5, but should work on other RedHat-like and SuSE distributions. If you are using the fsl_installer.sh script then you can carry out this configuration by running the script with the -E option.

## Customising

To customise FSL for particular ouput datatypes etc., see here.