Installation of AstroImageJ on a Linux Operating System
This page is to help with installing the latest version of AstroImageJ on
Linux operating systems. The files linked from the server are complete and do
not require a previous installation of ImageJ, AstroImageJ, or other software
to run. These instructions should work on any Linux distribution. They have
been tested most recently with OpenSUSE
If you already have installed version 2.0 of AIJ or later, simply use the update option
on the AIJ toolbar 'Help' menu to have the most recent version.
The user will need write
permission to the directory where the software is installed to use this feature.
To search for specific information, receive help from other users, or offer advice please see the
AstroImageJ user forum on
Follow these steps to install AstroImageJ so that it is available system wide to any user.
- Download the latest installation files into a convenient directory.
As root user, e.g with "su" or "sudo"
- AstroImageJ_v3.2.0_20160201_linux.tar.gz (provides AstroImageJ)
- AstroImageJ_script.tar.gz (provides a startup script for AstroImageJ)
Continuing as root user, if you already have AstroImageJ installed in /usr/local change it to a backup name such as AstroImageJ_old using
- cp AstroImageJ_v3.2.0_20160201_linux.tar.gz /usr/local/
- cp AstroImageJ_script.tar.gz /usr/local/bin/
- cd /usr/local
As root user untar the archives into /usr/local/ and clean up with commands like these
- mv AstroImageJ AstroImageJ_old
As root user you can check that AstroImageJ has been created in /usr/local with
- tar xvf AstroImageJ_v3.2.0_20160201_linux.tar.gz
- rm AstroImageJ_v3.2.0_20160201_linux.tar.gz
If you want ownership so that you alone can do the updates, then change the owner of the AstroImageJ directory to your own user name.
If you leave it with root ownership, you will have to run as root to do routine updates and this is not recommended. You may assign ownership to
any user and run it as another user. This change is for software maintenance.
- ls -l /usr/local/AstroImageJ
As root user go to /usr/local/bin, untar the scripts, add a convenient soft link, and clean up
- chown -R myname.users AstroImageJ
You may return to being a normal user now and try out AstroImageJ. Assuming /usr/local/bin is in your search path
- cd /usr/loca/bin
- tar xvf AstroImageJ_script.tar.gz
- ln -s astroimagej aij
- rm AstroImageJ_script.tar.gz
If there is a problem, try using the full path /usr/local/bin/aij to see if the software is working. The command
echo $PATH will show the default path for your system. You may need to add /usr/local/bin/ if you are using a system that has
only the basic software packages and is not yet set up for customization.
- aij or astroimagej commands will start the software
That's it! AIJ should now start up normally for any user on your system.
After installation you should allocate the memory your users will need, and check for AstroImageJ updates.
Both of these can be done at any time, and the updates will keep your installation current with bug fixes and new
features. Since Linux is a multi-user system, if you anticipate several users running AIJ simultaneously you may need to adjust the memory
made available to one instance accordingly.
You may need to increase the amount of memory allocated to AIJ using AIJ_Toolbar->Edit->Options->Memory & Threads. Enter the amount of memory in MB that you want allocated to AIJ. It is recommended to NOT exceed 2/3 of the physical memory installed in your system. For example, if your machine has 8 GB of memory, enter a memory
size up to ~5500 MB.
Click "OK" and close AIJ. Restart AIJ to use the new memory settings.
Finally, upgrade to the latest version of AIJ by using the built-in update feature. Go to AIJ_Toolbar->Help->Update AstroImageJ.
The "Upgrade To:" box will default to the latest version of AIJ. Click "OK" and the files will be downloaded and installed in the proper location in the installation directory structure (again, you need write access to the installation directory). After the files have been installed, AIJ will automatically close.
Restart AIJ to use the updated version.
AstroImageJ will run with either the Sun or OpenJDK Java packages.
For OpenSUSE we find that the default OS installation with OpenJDK works fine. The script astroimage you installed above is used to set the initial memory
allocation and may need fine tuning.
java -Xmx32768m -jar /usr/local/AstroImageJ/ij.jar
It is set for a large memory machine by the -Xmx32768m entry in the script.
You can change the allocation from 32 GB as it is here, to smaller amounts without issues other than to hold large stacks of images. The size will be
limited by the memory in your computer for 64-bit Java.
While this is not recently tested, some installations
of the KDE and Gnome window managers allow the user to control the double click timeout.
However, they do not convey this to the X11 display software,
so Java applications and many other programs that rely on X11 may default to a 200 millisecond timeout that is too short for most users.
The solution is to add the following line to either /etc/X11/Xresources (the system wide default in OpenSUSE), or add it to
a user basis to .Xresources in each user's home directory
The change will take effect when X is started the next time. This is not necessary with the lightweight xfce window manager.