Installing Helioviewer

To Use

Simply visit

However, if you wish to install the Helioviewer Project on your own machine this document has been created to aid you in this process.


First you will need to install all required packages. This guide has been designed to work with Ubuntu 20.04

sudo apt update;

sudo apt upgrade;

sudo apt install apache2 php7.4 php7.4-mysql php7.4-curl php-pear php-imagick php-mbstring php-bcmath php-redis libapache2-mod-php mysql-server redis-server imagemagick python3-mysqldb python-tk python3-tk python3-pip ffmpeg git libpng-dev libgsf-1-114 git ant

pip3 install sunpy glymur zeep bs4 drms lxml numpy scipy datetime pandas bokeh==2.2.1 matplotlib pathlib joblib

Clone source-code

Clone the api repository into webroot usually located in “/var/www”

git clone

Clone the front-end repository into webroot usually located in “/var/www”

git clone

cd into the folder and run the following command to pull in project dependencies

git submodule update --init

Setup the Database

The next step is to process your JPEG 2000 (JP2) images and enter their information into the database for efficient querying. If you don’t already have a JP2 dataset, you can download a sample dataset, e.g.:


mkdir /var/www/jp2/

tar zxvpf sample-data.tgz -C /var/www/jp2

If the MySQL daemon is not already running, start it:

sudo service mysql start

Change to the “api/install” directory and run the Helioviewer installation script:


Follow the steps shown on screen. Processing the JPEG 2000 archive may take anywhere from several minutes to many hours depending on the size of the archives, and the number of files to be processed. For a small dataset like the sample one provided above, processing should only be a matter of minutes.

Setup Kakadu

Kakadu binaries and shared libraries for 32-bit and 64-bit linux can be found in the install/kakadu directory. Select the appropriate archive based on your architecture and extract the files:

cd install/kakadu

tar zxvpf Kakadu_v6_4_1-00781N_Linux-64-bit-Compiled.tar.gz

Next, copy the Kakadu shared libraries and binaries to a known path, e.g.:

sudo cp lib/* /usr/local/lib/

sudo cp bin/* /usr/local/bin

Update dynamic linker cache:

sudo -s # enter root shell


exit # exit root shell

Now try running one of the Kakadu tools to make sure everything was set up properly:


Create Caching/Logging Directories

In order to function properly, Helioviewer requires write-access to several directories. Tiles, screenshots, and movies are stored in a “cache” directory and logs are stored in a “log” directory. Additionally, if you plan to use a JPIP server in conjunction with Helioviewer, a “movies” directory must be created within the JPEG 2000 archive so that generated JPX files may be accessed over JPIP.

mkdir -p log cache jp2/movies

Enable Apache to write to the directories:

chgrp www-data log cache jp2/movies

chmod 755 log cache jp2/movies

Modify Config File

Both the front-end and back-end of use a single configuration file named “Config.ini”, in addition to a separate database configuration file, “Private.php.” Both of these files are located in the api/settings directory. Example files, “Config.Example.ini” and “Private.Example.php,” are provided which are intended to be used as a basis for your own configuration.

Copy or rename these example files to “api/settings/Config.ini” and “api/settings/Private.php”, respectively.

Modify the “Config.ini” file so that the information (filepaths, etc) accurately reflect your server configuration.

By default, the “compress_js” and “compress_css” parameters are set to “true” and Helioviewer will expect to find minified versions of the javascript code and cascading stylesheets. Either set these parameters to “false”, or run Apache Ant on the “scripts/build.xml” file to build the necessary products:

cd helioviewer/resources/build


Modify the database credentials in the “Private.php” file with the values you entered in the installation GUI.

It is recommended to use a virtual host configuration within apache to direct requets to the api under a subdomain.

All done!

To test the installation, open your web browser of choice and navigate to the location where Helioviewer is installed. If you installed Helioviewer to /var/www/helioviewer, you can view the website at http://localhost/helioviewer/.