HKL-3000 Installation Instructions

These instructions are also available as a  PDF document.

The installation of the HKL-3000 software is now guided by the installation program. The HKL-3000 installer can be obtained from HKL Research, Inc. by clicking the link below and signing in as user hkl3000ftp:


The password can be obtained via the Automatic Password System or by e-mail to (established users only).

The installer is provided as a compressed file, and the file name indicates the system for which the installer will operate.  Three versions are currently available, and the installation process is essentially the same for Linux and Mac. Please see a separate chapter on the installation on Windows.

  • HKL_installer_v7##-Linux-x86_64.tar.gz

You may download and unpack the installer anywhere on your system.  The installer will guide you through the installation process, including specifying where the program should be installed. You will need root permission to install HKL-3000 in the default location /usr/local/HKL, but you can install HKL-3000 in any directory.

After downloading the appropriate file, uncompress it using your preferred method.  For example, on most Linux systems, you can use the graphical interface (right-click and select Extract Here) or the command line (tar zxfv HKL_installer_v7##-Linux-x86_64.tar.gz).

Extracting the compressed file will create a folder that contains the installer, README.txt, access_prod, and a folder named “setup_files”.  README.txt is meant to serve as installation help in a condensed form. Access_prod is a program that gathers information necessary to generate a license key.  Run access_prod and email the output (info file) to A more detailed explanation of this step is available on the HKL Research website.

You can start the installer by double clicking the installer icon or by using the command line. If you plan to install the program in the standard location [/usr/local/HKL], you will need to start the program with sudo permissions (sudo ./HKL_installer). 



CCP4 and SHELX should be installed before running the HKL_installer. Presently CCP4 includes SHELX distribution and all necessary programs can be downloaded from: 

The installer will first verify that your license key is valid. The traditional location of the license key file (cr_info) is /usr/local/lib. (on some systems, you may need to create this directory).

The Installation Type buttons allow you to choose the HKL version you would like to install: HKL-2000, HKL-3000sm, or HKL-3000, provided you have a license for it and the appropriate license key.  HKL-3000sm includes additional features for small molecules.  Click “Continue” to view the version-specific license agreement.  You must accept the license conditions to proceed.

The screen below will let you choose whether you want to create a new HKL installation or upgrade an existing installation. If you have selected HKL-3000sm or HKL-3000, a dialog box will appear requesting the location of the external programs used by HKL-3000.  The installer may be able to determine the location of some of them based on your environmental variables. If you still need to select some programs, the installer can search for the files for you. Use the “Select” button at the bottom of the dialog to select the parent directory that contains one or more of the necessary programs.  In the example shown below, all of the files not defined by system variable were found using the parent directory “/usr/local/xtalprogs”.

The next dialog allows you to specify the program location and the detector definition directory. The default locations are /usr/local/HKL and /usr/local/hklint.  You can change them if you want to use a different directory or you do not have write permission for these directories.  The default folder for HKL will include the version number. The following example uses non-standard locations that would not require root privileges.

The installer will then check if you have permission to write to these directories and run checks to verify that the external programs are correctly installed.  If everything looks good, click “Install” to finish the setup.

If you let the installer create an icon, you can now use it to launch HKL-3000.