Installing on Unix
The Jalview SH installer for Unix should be run from the command line. It may be necessary to make the file executable.
The installer will then guide you through the installation options. In most cases we recommend accepting the default options.
If you just want to run the graphical installer, download the SH file and from a console run
If you have problems, you can make the SH file executable and run it directly with:
The TGZ File is simply an archive of the application directory. You can unpack it with the command
which will create a single directory
jalview with the application inside.
Whilst this installation will, when run, keep itself up to date with the latest version of Jalview, you will not benefit from some of the installer functions such as file associations.
Java 8 Required
Jalview is an application that uses a Java Runtime Environment (JRE) to run. The macOS, Windows and Linux installers bundle a JRE in the Jalview application directory so that no external JRE is required.
Since the Unix installer is more generic, bundling the correct JRE is not possible, so an external JRE will be required. Whilst the installer will run with several versions of Java, the current release of Jalview requires Java 8 (also designated Java 1.8!).
You should consult your operating system’s package management to see if a system-wide Java 8 JRE is available to install or already installed. Note that a Java Development Kit or JDK includes a complete JRE so if you have a JDK version of Java 8 installed you shouldn’t need to install a JRE as well.
A simple way to see if you have a Java 8 JRE installed is to run the command
If a Java 8 JRE isn’t available in the package manager, or you don’t have permissions to perform system installations, you can install a user-space JRE. We recommend the Adoptium OpenJDK packages which covers all the main OS and architeture combinations.
Other OS/architecture combinations are catered for with binary packaging of OpenJDK Java 8 at
It might be that you have a system wide Java that is not Java 8, which is being picked up by Jalview (often manifesting as a broken network). In this case you can override the system Java and point Jalview at your own Java 8 by using the
INSTALL4J_JAVA_HOME_OVERRIDE environment variable. You can run Jalview from the command line like this:
Verifying the SHA256 checksum
The download page provides a SHA256 checksum that you might want to use to verify your download. To do this in unix, open a console and use the command
The output checksum should match the checksum displayed on the download page.
Installing using the command line
The same SH file can be used on the command line to install Jalview if required. In this case we recommend making the SH file executable first:
In a Command Prompt, change folder to where you downloaded the file and run it with
In a Command Prompt, change folder to where you downloaded the file and run it with the
Optionally you can set the installation directory with the
-dir option followed by the directory, e.g.
Note that due to Jalview’s automatic updates it is best to install Jalview in the user’s own disk space.
Changing the defaults
To set different defaults for an installation using the SH installer (most useful when using unattended mode), please read install4j Help: Response Files.
The default response file values that you might want to change for a Jalview installation look like
sys.fileAssociation.extensions$StringArray, you must also remove or add the same number of launcher IDs (
"JALVIEW") to the
To use your own defaults
varfile run the installer with the
-varfile option and the name of the file, e.g.
If you need more information about using the installer on the command line please see
- install4j Help: Installer Modes
- install4j Help: Command Line Options For Generated Installers
- install4j Help: Response Files
or contact us on the Jalview Discussion Forum