~~NOCACHE~~





====== Download and installation ======

Before continuing, you may want to read the [[Dependencies|list of dependencies]]

===== Download GCstar sources =====

You can download gcstar through this link:

[[http://download.gna.org/gcstar/gcstar-[VERSION].tar.gz|download GCstar v[VERSION] ]]

Change to directory where this file has been saved and enter:

<terminal>tar zxf gcstar-[VERSION].tar.gz</terminal>

A **gcstar** directory will be created. It contains the installation script, **install**. Change to this directory. You now have to choose between three kind of installations detailed in next chapters.

But before, let's see what is common to all these installations. They all check for the dependencies and stop the installation procedure if one is missing. You can then choose base directory for installation. You will have then this tree:

  * **Base directory**
    * /bin
      * Main GCstar executable
    * /lib
      * /gcstar
        * GCstar libraries
    * /share
      * /gcstar
        * Internal data used by GCstar

The executable in bin directory can be launched. If your PATH variable contains this directory, just type in:

<terminal>gcstar</terminal>



===== Graphic mode installation =====

To proceed with a graphical installation, just launch install without any parameter.

<terminal>./install</terminal>

You will see then a window. In this window there will be information about the dependencies.

{{en:install.png|Graphical installation}}

If some mandatory dependencies are missing, the installation won't be possible. But there are some optional dependencies that will only disable some features when not filled. They will be listed with the name of the modules that require them.

Using **Forward** gives access to base directory selection, and then to some settings.



===== Text mode installation =====

If parameter **-- text** is given to install executable, a text mode installation will be used.

<terminal>./install --text</terminal>

The base directory has then to be specified.
















===== Automatic installation =====

GCstar can be installed in an automatic way. The base directory must be passed to install program using **--prefix** command line option. As an example:

<terminal>./install --prefix=/usr/local</terminal>







===== Specific installations =====

There are convenient ways to install GCstar on some systems. There are described in other pages listed under. Most of the packages are external contributions. So they may be out of synchronization with last offical one (the .tar.gz one).

  * [[Install Linux]] (Contains instructions for several distributions)
  * [[Install FreeBSD]]
  * [[Install Macos]]
  * [[Install Windows]]