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


Intel Core i3 3rd Generation or similar


OpenGL 3.0 support / Intel HD 4000 / Nvidia GeForce 8400 GS, 500 MB GRAM



Hard drive

230 MB of free space


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.


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.


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.


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


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


If you want to compile the source code, you will need the following:

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
$ 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.