Installing from ZIP
Installing GanttProject from platform-independent ZIP archive
unzip ganttproject-2.8.10-r2363.zip && cd ganttproject-2.8.10 && ./ganttproject
Normally you install GanttProject using platform-specific packages, such as executable installer on Windows or deb package on Linux. However, sometimes you may want to use platform-independent ZIP archive.
There are a few cases when you may want to install GanttProject from ZIP archive:
- anti-virus software reports viruses in the native installer
- there is no installer or other native package for your operating system (e.g. you are on OpenSolaris)
- launcher from the native installer doesn't work (e.g. nothing happens when you click GanttProject icon in your Programs menu on Windows)
- you want to do some other debugging stuff, e.g. see messages printed to the console
- you want to keep a few different versions of GanttProject
- you want to modify GanttProject startup parameters, e.g. use some other JRE or give more memory to the Java VM
In the most simple case installing is very easy: unzip
ganttproject-2.8.10-r2363.zip file to any directory on your disk drive, and run a launcher script from the installation directory. The script you need to run is
ganttproject.bat on Windows,
ganttproject.command on MacOSX and
ganttproject.sh on Linux/UNIX systems. If your environment meets prerequisites, it is very likely that you will see GanttProject starting and running.
What if it doesn't work
Hard prerequisite: you need to have Java Runtime (aka JRE). We recommend using JRE 8 from Oracle or OpenJDK, although more recent versions, such a Java 10, shall also work fine. GanttProject may or may not run on Java from other vendors.
Soft prerequisite: it is nice if you can run
java executable from console. On Windows console application is called Command line prompt, on MacOSX it is called Terminal. Linux guys hopefully know how to open console (okay, it is called Terminal on GNOME desktops or Konsole in KDE). Open console, type
java -version and hit enter. If you see something like
$ java -version java version "1.8.0_45" Java(TM) SE Runtime Environment (build 1.8.0_45-b14) Java HotSpot(TM) 64-Bit Server VM (build 25.45-b02, mixed mode)
then you're OK. If you see a message which says something similar to "java not found", bad luck. You may try reinstalling Java, but if for some reasons you can't or don't want to do it, please read the next section
JAVA_HOME environment variable
You need to do it if you're absolutely sure that JRE is installed, but you can't run
java from console or if you want to use some other non-default JRE. The following text assumes that your system is Windows and GanttProject is installed in C:\GanttProject
Your task it to point a launcher script to the location of the JRE on your system. First, find that location :) If you have absolutely no idea how to do it, search for
java.exe file. JRE is usually installed in a directory with the following structure:
<lots of files> bin | +-- <lots of files> +-- java.exe lib | +-- <lots of files>
This directory is your Java home. Copy the full path to that directory (e.g.
C:\Program Files\Java\jre6), open
C:\GanttProject\ganttproject.bat in your favorite text editor and add the following at the first line:
C:\Path\To\Your\jre with the actual location of your Java Runtime.