Build: Linux

---

Installing SetiAstro Suite Pro on Linux

Option 1: Installer (Recommended)

Download the installer from the [GitHub releases page](https://github.com/setiastro/setiastrosuitepro/releases) and run it from a terminal:

chmod +x install-saspro.sh
./install-saspro.sh

This installs SASpro via pipx, adds a desktop icon, and registers it in your application library. The setiastrosuitepro command is exposed globally, so PixInsight and other external tools can call it directly without any venv activation.

If pipx isn't already installed, the installer will set it up automatically. If that fails for any reason, you can install it manually first:

sudo apt install pipx && pipx ensurepath

Then re-run the installer.

Fedora, OpenSuSE, Tumbleweed users: A community-rewritten installer for them is available on the [SASpro Discord](https://discord.com/channels/1257377319765413961/1510859989072347258).

---

Option 2: Running from Source (GitHub clone)

This is similar to the Windows developer setup. You will need Python 3.12 or newer and git.

Python version: Python 3.12 or newer is required. Python 3.14 (the default on Ubuntu 26) has been verified to work. If you are on an older Ubuntu and need to install Python 3.12 manually:

sudo apt install python3.12 python3.12-venv python3.12-dev

Then clone and set up:

git clone https://github.com/setiastro/setiastrosuitepro.git
cd setiastrosuitepro

Create a virtual environment. On Ubuntu 26 with Python 3.14 as default:

python3 -m venv venv

On older Ubuntu with manually installed Python 3.12:

python3.12 -m venv venv

Then activate and install:

source venv/bin/activate
pip install -e .

To run SASpro:

source venv/bin/activate
python -m setiastro.saspro

For PixInsight integration from source, set the launcher mode in the Cosmic Clarity script to python -m setiastro.saspro cc and point it at your venv's Python executable.

---

Notes

• Python 3.12 or newer is required. Ubuntu 26 ships Python 3.14 by default which works fine.
• Linux support is more limited compared to Windows and macOS. If you run into issues, the [Discord](https://discord.gg/PZpVFpjhfK) is the best place to ask.

---