General installation of OSA docker image to run the analysis

First of all, it is necessary to install Docker on your platform. We do not provide support on this, instructions can be retrieved from the docker project to which we refer. Instructions are specific to your OS distribution (see https://docs.docker.com/install/). For a quick use, we suggest to read the first two paragraphs below (Graphical interface for Linux and Mac, Downloading the OSA docker image) and then just to Section .

Graphical interface, special instructions for Mac users

Note that these instructions could not be tested on the latest versions after 2020
The interaction with the graphical environment is platform dependent and needs to be properly set-up. For Linux you need to make sure that X11 is installed and that you are in a graphical session.

For OSX, the following instructions have been developed by CERN for the ``root'' program and are also valid for OSA, which uses ``root'' for its graphical interface (we refer for details an updates to the page https://hub.docker.com/r/rootproject/root-ubuntu16/

1. Make sure that https://www.xquartz.org/XQuarz is installed. If not, install it from here: https://www.xquartz.org/
2. Open XQuartz, go to XQuartz, Preferences, select the Security tab, and tick the box ``Allow connections from network clients''. Then, quit XQuartz.
3. Open Terminal and issue the following command:
   grep inet | awk '$1==inet {print $2}')
   This will grab your IP address on the local network.
4. Run echo $ip to make sure it was successful. If nothing is displayed, replace ``en0'' by ``en1'' or a higher number in the above command.
5. Try again until it works.
6. When you have successfully defined the variable ip to store your IP address, issue the command: xhost + $ip
   This will start XQuartz and whitelist your local IP address. A message should be displayed saying that the IP address has been ``added to the access control list''.