Installation of AstroImageJ on Mac OSX
This page is to help with installing the latest version of AstroImageJ on the Mac operating systems.
The files linked from the server are complete and do not require a previous installation of ImageJ or AstroImageJ, or other
software to run.
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.
For more information, help from other users, and to post advice or questions please see the
AstroImageJ user forum on
One-step AIJ installation is not directly compatible with OS X 10.12, 10.13, or 10.14+.
There are currently two procedures that are tested to work. The simplest
only requires a command to be executed in a terminal window once the package is installed:
- Download the latest installation file.
- Unzip the installation file and move the AstroImageJ folder to the Applications folder
- Run this command in Terminal
xattr -r -d com.apple.quarantine /Applications/AstroImageJ
That's it! AIJ should now start up normally. If it does, then follow the instructions below
for what to do after the installation.
There is no need to run both methods. We expect the first one will work for most users.
However, if it does not, perhaps due to an unexpected change in IOS, you could try
this previous workaround that is a bit more complicated and requires superuser login.
- If you haven't already, Install AIJ by unzipping the install file and dragging the resulting AstroImageJ folder to the Applications folder.
- Open the Terminal app from the /Applications/Utilities/ folder and then enter the following command syntax: sudo spctl --master-disable
- Hit return and authenticate with an admin password.
- Relaunch System Preferences and go to the Security → Privacy → General tab.
- You will now see the Anywhere option under Allow apps downloaded from:. Select this option.
- Make a copy of /Applications/AstroImageJ/AstroImageJ64.app on the desktop. An easy way to do that is hold down the alt key while dragging AstroImageJ64.app from the /Applications/AstroImageJ folder to the desktop.
- Delete the original copy of AstroImageJ64.app that is still in the /Applications/AstroImageJ folder.
- Drag the copy of AstroImageJ64.app from the desktop back to the /Applications/AstroImageJ folder.
- Start AIJ and set up your memory settings as needed.
- Close AIJ.
- After running AIJ the first time, enter the following command syntax to reenable GateKeeper (AIJ will continue to work normally): sudo spctl --master-enable
After installation you should allocate the memory your uses 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
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 three 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.
On the Mac with this installation procedure
AIJ can be started by double-clicking either the AstroImageJ.app
or the AstroImage64.app icons.
Either app can be dragged to the Dock to provide convenient
access for starting AIJ.