In principle, installing SIRIUS just means extracting the archive you have downloaded to an arbitrary directory where you have write permissions. The Java Runtime Environment (JRE) needed to run SIRIUS is already included.

For Windows/MacOS we also provide installer packages (msi/pkg) which should be preferred but might require admin permissions. Since we do not pay Microsoft/Apple for certification you might have to confirm that you want to trust software from an unknown source on Windows/MacOS.

If you have trouble installing SIRIUS, please let us know and we will see if we can help. If you find that our installation guide is incomplete, or if you have some tricks that you want to share with your fellow scientists, please let us know, so we can include them in this manual, or even better, contribute them yourself.

Warning All advice given here on how to get SIRIUS running on your system, is given without any warranty! If you are not sure what you are doing, you might want to contact someone who does. (Remember, last Friday in July is System Administrator Appreciation Day!)

Windows

MSI installer (preferred)

Execute the installer, trust the unknown source and follow the instructions. You will have the option to choose an installation location and need to accept the SIRIUS license agreement. The installer should also create a start menu entry for SIRIUS.

Zip package

Extract the archive to an arbitrary directory where you have write permissions, such as C:\SIRIUS.

Execution

Go to the SIRIUS directory. Run sirius-gui.exe to start the graphical user interface. You might want to create a link on your desktop: Click and drag the file to the desktop, keeping the ALT key pressed. You can rename the link on your desktop as you like. You start SIRIUS by double-clicking this link.

Run sirius.exe for the SIRIUS command line tool. To execute the SIRIUS command line tool from every location on your system, you have to add the location of the to your PATH environment variable: Open the Windows Setting, type “advanced” in the search window, say “yes” if Windows asks you. Press the “Environment Variables” button, select the “Path” variable in the lower panel, press “Edit”, press “New”, enter the full directory path of SIRIUS, press RETURN. Close the Command Prompt, open a new one, type sirius.

Mac OSX

pkg installer (preferred)

Execute the installer, trust the unknown source and follow the instructions. You will have the option to choose an installation disk and need to accept the SIRIUS license agreement. The option to confirm the execution an installer form an unknown might be “hidden” under "System Settings" -> "Security & Privacy".

Zip package

Extract the archive to an arbitrary directory where you have write permissions, e.g. Download folder. You can then move/copy the extracted .app folder to your application directory. You might have to define gate keeper exceptions for all libraries in the SIRIUS .app directory. If you are not sure how to do this we recommend using the installer version.

Execution

To run the SIRIUS GUI just go to you app directory an double click the sirius-gui app. You can also add SIRIUS to your dock if you like.

To start the SIRIUS command line tool go to the sirius app directory and execute the sirius launcher.

Linux

Zip version

Extract the archive to an arbitrary directory where you have write permissions, e.g. /home/opt/sirius.

To start the commandline version of SIRIUS execute the <SIRIUS_DIR>/bin/sirius starter in the terminal.

To start the graphical user interface of SIRIUS execute the <SIRIUS_DIR>/bin/sirius-gui starter in the terminal.

To execute SIRIUS from every location you have to add the <SIRIUS_DIR>/bin to your PATH variable. To do so, open in an editor and add the following line (replacing the placeholder path) to your ~/.bashrc:

export PATH=PATH:<SIRIUS_DIR>/bin/

Note that you have to reopen your “bash” shell to make the changes effective.

Installing Gurobi and CPLEX

SIRIUS ships with the COIN-OR Integer Linear Program solver which allows us to swiftly compute fragmentation trees in most cases. However, if you want to analyze large molecules and/or spectra with many peaks and/or a large number of spectra, you can improve running time by using a faster solver. SIRIUS also supports Integer Linear Program solvers Gurobi and CPLEX . These are commercial solvers which offer a free academic license for university members. You can find installation instruction on their websites. Using Gurobi or CPLEX will improve the speed of fragmentation tree computations, which is the most time-intense step of the computational analysis. Beside this, there will be no differences in using Gurobi, CPLEX. To use Gurobi set the environment variable GUROBI_HOME to a valid Gurobi installation location e.g. /opt/gurobi702/linux64. Similarly, to use CPLEX set CPLEX_HOME to e.g. /opt/ibm/ILOG/CPLEX_Studio1271/cplex. SIRIUS will automatically use Gurobi or CPLEX as its solver if corresponding environment variables are specified. You can specify the preferred ILP solvers in the settings dialog (GUI) or via the command line --ilp-solver.

Proxy servers

To use database related functionality of SIRIUS, it needs an Internet connection. You have to ensure that SIRIUS is not blocked by any security software on your computer.

If you have to use a proxy server to connect to the Internet, SIRIUS automatically uses the system wide Java proxy configuration if available. Alternatively you can specify the proxy configuration in the Sirius user interface setting (see Settings).

If SIRIUS cannot connect to the Internet, it will report on which stage the error occurred.