Starlink installation via rsync

You can rsync from the EAO's dev builds in Hilo if you want a 64-bit Linux. This used to be a nightly build, but currently is only being updated manually at irregular intervals (Unfortunately at the moment we don't have a nightly updated macOS build, but the notes are left below in the hope we can restore this at some point). These are automated builds, started out every morning (HST) if there have been any code changes pushed to the GitHub repository in the previous 24 hours. They should include StarJava and ORAC-DR.


To rsync from our nightly Linux 64 bit build on CentOS 6 you can do:

The Git hash and date of the current nightly build on CentOS 6 can be viewed at

We also produce similar automated nightly builds for CentOS 7 and Ubuntu 17.10. These builds have not yet been widely used or tested, so please let us know if you encounter any problems. You can rsync them as:

Centos 7: . rsync -avz --delete  rsync:// star-nightly/

or Ubuntu 17.10: rsync -avz --delete rsync:// star-nightly/


The following macOS nightly build is created on a machine running Mojave. We believe it should work on versions as old as 10.9 but we do not have the ability to test on any older versions of macOS.

The Git hash and date of the current nightly build on macOS can be viewed at


  1. An up-to-date XQuartz X11 distribution must be installed. If you already have XQuartz installed but need to update it, you can run the application and go to the top menu and select: X11->Check for X11 updates. If you need to install the software, it can be found here:

  2. A recent Java JRE must be installed to use the StarJava programs topcat, splat stilts and frog. This can be found at To check if you have Java installed already, open a terminal, type java -version and see if the command is found, and if you have 1.8 installed.

There should not be any other dependencies for installing the macOS build; this is a change from previous releases which required manual installation of various libraries.


If you encounter any problems with these builds, email for assistance.

Post-installation Run-up

To set up your environment for use with the Starlink Software Collection, first set the STARLINK_DIR environment variable to the location of the stardev directory. For example, if you rsync into to /home/person/software, set the STARLINK_DIR environment variable to /home/person/software/stardev. It is recommended that you edit the stardev/etc/login, stardev/etc/cshrc and stardev/etc/profile files to set this environment variable at the top of each file.

To use the Starlink Software Collection on csh and related shells (like tcsh), source $STARLINK_DIR/etc/login and $STARLINK_DIR/etc/cshrc. On sh and related shells (like bash), source $STARLINK_DIR/etc/profile.

For more details please see the installation page for the most recent release.


Because of the large size of WFCAM calibration files, they have been split off from the main download tarballs, as not everybody will be reducing WFCAM data using ORAC-DR. These calibrations can be downloaded here (901MB .tar.gz). The tar file will unzip into a wfcam/ directory in the directory you downloaded the tar file to. To install these calibration files, copy the directory into the $STARLINK_DIR/bin/oracdr/cal/ directory, thus creating the $STARLINK_DIR/bin/oracdr/cal/wfcam/ directory containing the calibration files.

Starlink: rsyncStarlink (last edited 2023-12-20 20:11:12 by SarahGraves)