.. _qs-installation:

Installation
------------

Find below the download and installation procedure.

Download
^^^^^^^^
First, you need to download the installer or package, if you have not done so. Packages are available for **Linux**, **macOS** and **Windows**. You can either download the `Gaia Sky build <https://gaiasky.space/downloads>`__ for your operating system (recommended) or browse and `build the source code <https://codeberg.org/gaiasky/gaiasky>`_.

*  `Gaia Sky downloads page <https://gaiasky.space/downloads>`__

We also maintain `Flatpak <https://flathub.org/en/apps/space.gaiasky.GaiaSky>`__, and an `AUR <https://aur.archlinux.org/packages/gaiasky>`__ packages.

Installation procedure
^^^^^^^^^^^^^^^^^^^^^^
Depending on your system and your personal preferences the installation procedure may vary. This section describes the installation and running process for the different operating systems and packages.
Find the full installation procedure for your operating system in the :ref:`installation section <installation>` of the user manual. Below are direct links:

- Install on :ref:`Linux <install-linux>`
- Install on :ref:`macOS <install-macos>`
- Install on :ref:`Windows <install-windows>`

.. _qs-running:

Running
^^^^^^^

To run the software, use the provided shortcut, found in the applications menu of your operating system. If you downloaded the ``.tar.gz`` package, extract it and run the provided ``gaiasky`` or ``gaiasky.cmd`` file. If you used the ``AppImage``, give it execute permissions (``chmod +x``), and then run it.