Requirements and Installation¶
In the sections below is the information on the minimum hardware requirements and on how to install the software.
System requirements¶
Here are the minimum requirements to run this software:
Operating system |
Windows 7+ / MacOS X / Linux |
|---|---|
CPU |
Intel Core i3 3rd Generation or similar |
GPU |
OpenGL 3.0 support / Intel HD 4000 / Nvidia GeForce 8400 GS, 500 MB GRAM |
Memory |
3 GB RAM |
Hard drive |
230 MB of free space |
Java |
On Linux, you need the Java Runtime Environment 7+ installed (openJRE is fine) |
Installation and uninstallation¶
Depending on your system and your personal preferences the installation procedure may vary. Below is a description of the various installation methods available.
Windows¶
Two windows installers are available for 32 and 64-bit systems.
gaiasky_windows_<version>.exe– 32 bit installer.gaiasky_windows-x64_<version>.exe– 64 bit installer.
To install the Gaia Sky, just double click on the installer and then follow the on-screen instructions. You will need to choose the directory where the application is to be installed.
In order to uninstall the application you can use the Windows Control Panel or you can use the provided uninstaller in the Gaia Sky folder.
Linux¶
We provide 3 packages for linux systems (deb for Debian, Ubuntu
and derivatives, rpm for RedHat, Fedora and derivatives and a
linux installer which works on all distros) plus an AUR
package for Arch and
derivatives.
deb
This is the package for Debian-based distros (Debian, Ubuntu,
Mint, SteamOS, etc.).
Download
the gaiasky_<version>.deb file and run the following command. You
will need root privileges to install a deb package in your system.
$ dpkg -i gaiasky_<version>.deb
This will install the application in the /opt/gaiasky/ folder and it
will create the necessary shortcuts and .desktop files. The package
depends on the default-jre package, which will be installed if it is
not yet there.
In order to uninstall, just type:
$ apt-get remove gaiasky
rpm
This is the package for RPM-based distributions (Red Hat, Fedora,
Mandriva, SUSE, CentOS, etc.)
Download
the gaiasky_linux_<version>.rpm file and run the following command.
You will need root privileges to install a rpm package in your
system.
$ yum install gaiasky_linux_<version>.rpm
This will install the application in the /opt/gaiasky/ folder and it
will create the necessary shortcuts.
In order to uninstall, just type:
$ yum remove gaiasky-x86
Install from AUR
If you have Arch, Manjaro, Antergos or any other Arch Linux derivative, you can install the package from AUR using any tool able to install AUR software. For example:
$ yauort -S gaiasky
This will download the package and install it in the /opt/gaiasky/ folder. It also
creates the necessary shortcuts.
Unix/Linux installer
We also provide a Unix/Linux
installer
that will trigger a graphical interface where you can choose the
installation location and some other settings. Download the file
gaiasky_unix_<version>.sh to your disk. Then run the following to
start the installation.
$ ./gaiasky_unix_[version].sh
Follow the on-screen instructions to proceed with the installation.
In order to uninstall, just execute the uninstall file in the
installation folder.
OS X - Mac¶
For OS X we provide a gaiasky_macos_<version>.dmg file
here,
which is installed by unpacking into the Applications folder. Once
unpacked, the installer will come up, you just need to follow its
instructions.
Compressed (TGZ) package¶
A gaiasky-[version].tgz package file is also provided
here.
It will work in all systems but you need to unpack it yourself and
create the desired shortcuts. In Windows, use an archiver software
(7zip, iZArc, etc.) to unpack it.
In Linux and OS X, you can use:
$ tar zxvf gaiasky-<version>.tgz
Running from source¶
Requirements¶
If you want to compile the source code, you will need the following:
JDK7 or above (JDK8 recommended)
Please, be aware that only tags are guaranteed to work
(here). The master
branch holds the development version and the configuration files are
possibly messed up and not ready to work out-of-the-box. So remember to
use a tag version if you want to run it right away from source.
Also, this guide is for Unix-like systems only. If you are working on Windows, you will need git for windows and Power Shell, even though it has not been tested.
First, clone the repository:
$ git clone https://github.com/ari-zah/gaiasky.git
$ cd gaiasky
Compile and run¶
To compile the code and run the desktop version of the application:
$ gradlew desktop:run
Package Gaia Sky¶
To pack the application into a tar file:
$ gradlew desktop:createTar
In order to produce the desktop installers for the various systems you
need a licensed version of Install4j.
$ gradlew desktop:pack
These commands will compile and package the application into a
gaiasky-[version] folder under the gaiasky/releases folder.