Linux: How to Download, Install, and Start APT
APT is supported on Redhat Enterprise Linux. APT is currently tested on a RHEL 9 system. The basic OS requirement is RHEL 7 (or higher), Ubuntu 18.04 (or higher) (and equivalents).
APT is available for 64-bit kernal computers only. (To determine which you have type: "uname -a". If you see "x86_64" you have a 64-bit kernel.)
You will need a PDF reader installed on your machine.
Depending on your institution's computer security measures (firewalls, blocked ports, etc.), you may initially have communication trouble with APT. If you have any concerns please see our Server Connectivity knowledge article.
1. Uninstall the previous version
Note: If you are going to install APT in the same directory as a previous version, please remove the previous version first. But if you are going to install in a separate directory, you would only need to uninstall to save disk space (and possible version confusion).
To get rid of the old version: Delete the entire directory tree where you installed it. (The unix command
rm -rf [directory]
makes this quick because it gets rid of all the subdirectories and does not ask you about overriding permissions.)
2. Download and install
Download the installer below and open a shell and cd to the directory where you downloaded the installer.
To install type:
(If you have trouble installing APT, please see the Troubleshooting Tips at the bottom of these platform specific Installation instructions.)
Once you have installed APT you invoke it with a script. For instance to start APT type
in the installation directory. (By default the installation directory is placed in your home directory.) Links are no longer put in your home directory automatically. If you would like to create your own link, here is is the unix command to use in your home directory to create a link named 'apt':
ln -s [your_installation_directory]/APT apt
4. How to find out about new releases
We maintain a distribution list for announcing new releases of APT. This may be helpful to people who install APT for others to use. Just send a blank email to: email@example.com (Unsubscribe by sending a blank email to firstname.lastname@example.org)
If there are problems with the installation you can turn on debug logging and sometimes that will reveal the problem. This debug log would also be useful to send us if you can't figure out the problem. Contact us (through email@example.com) if you have problems with installation. It would also be useful to tell us your exact flavor of linux which you can get from the commands:
To turn debug logging on during installation: Execute these commands in the directory where you downloaded the installer (install-linux-apt.sh):
sh install-linux-apt.sh --keep --noexec cd install-linux-apt jre/bin/java -DTRACE=true -jar install-linux-apt.jar
To turn debug logging on while running APT: add a command line switch when you invoke APT:
./APT -debug all
Known Installation/Download Problems:
- We have recently had a report of a Linux user who found APT looked incredibly small (all the icons and tabs). This is due to a know bug with scaling for Linux in Java. There is a workaround that involves setting environment variable GDK_SCALE. (Both "setenv GDK_SCALE 2.0" or "GDK_SCALE=2 ./APT" worked for this user.) Contact us (through firstname.lastname@example.org) if you have problems with screen resolution that you cannot address with this work around. (93346)