Build: Linux

Installing SetiAstro Suite Pro on Linux

Option 1: Standalone Desktop Install (Recommended for most users)

Download the installer from the GitHub releases page and run it from a terminal:

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

This installs SASpro, adds a desktop icon, and registers it in your application library. This is the easiest option and works out of the box.

Fedora users: A community-rewritten installer for Fedora 44 is available on the SASpro Discord.

---

Option 2: PixInsight Integration (pipx install)

If you want to use SASpro with PixInsight's Cosmic Clarity script, the standalone installer won't work because PixInsight invokes SASpro outside of any virtual environment. You need a system-level install using pipx instead.

Install pipx if you don't have it:

sudo apt install pipx
pipx ensurepath

Then install SASpro:

pipx install setiastrosuitepro --force

To upgrade later:

pipx upgrade setiastrosuitepro

Why pipx and not pip? The standalone installer creates a virtual environment and installs SASpro inside it. PixInsight's script launcher doesn't know how to activate that venv, so it can't find SASpro. pipx installs SASpro into its own isolated environment but exposes the setiastrosuitepro command globally, which is what PixInsight needs.

---

Option 3: 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 is the best place to ask.