Skip to content

Installation

openstan is distributed as a self-contained native installer for each supported platform. No Python installation is required — all dependencies are bundled.

Download

All installers for the latest release are available on the GitHub Releases page.

Platform Installer Download
Windows 10 / 11 .msi Download
macOS 12+ (Intel & Apple Silicon) .dmg Download
Ubuntu / Debian (x86_64) .deb Download
Ubuntu / Debian (ARM64) .deb Download
Fedora / RHEL (x86_64) .rpm Download
Fedora / RHEL (ARM64) .rpm Download

Windows

  1. Download the .msi installer from the latest release.
  2. Double-click the .msi file to launch the installer.
  3. Follow the on-screen prompts. openstan is installed per-user by default (no administrator rights needed).
  4. Launch openstan from the Start menu or desktop shortcut.

Windows SmartScreen

Windows installers are code-signed via Certum Open Source Code Signing certificate. SmartScreen may still show a warning on first run for newly signed applications. Click More info → Run anyway to proceed. See the Code signing policy for details.

macOS

  1. Download the .dmg disk image from the latest release.
  2. Open the .dmg and drag openstan into your Applications folder.
  3. Double-click to launch openstan. The app is signed and notarized by Apple, so Gatekeeper will trust it automatically.

Gatekeeper

openstan macOS builds are signed with an Apple Developer ID certificate and notarized by Apple. You can launch the app normally — no right-click workaround is required. See the Code signing policy for details.

Linux (Debian / Ubuntu)

Download the .deb package from the latest release matching your system architecture (x86_64 or ARM64) and install it:

sudo apt install ./openstan-*.deb

After installation, launch openstan from your application menu, or run openstan in a terminal.

Both x86_64 and ARM64 packages are available.

Dependencies installed automatically

The .deb package declares libxcb-cursor0 as a runtime dependency; apt will install it automatically. All other libraries (Qt, Python, OpenSSL, etc.) are bundled inside the installer.

Linux (Fedora / RHEL / CentOS)

Download the .rpm package from the latest release matching your system architecture (x86_64 or ARM64) and install it:

sudo dnf install ./openstan-*.rpm

Both x86_64 and ARM64 packages are available.

Running from source

If you prefer to run openstan directly from the source code (for development or to use the very latest changes):

Prerequisites

  • Python 3.14 or later
  • uv package manager

Steps

# Clone the repository
git clone https://github.com/boscorat/openstan.git
cd openstan

# Install all dependencies
uv sync

# Run the application
uv run openstan

On Linux you will also need the Qt XCB system libraries:

sudo apt-get install -y \
  libegl1 libgles2 libxcb-cursor0 libxcb-icccm4 libxcb-image0 \
  libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-shape0 \
  libxcb-xinerama0 libxcb-xkb1 libxkbcommon-x11-0 \
  libdbus-1-3 libfontconfig1 libfreetype6

Upgrading

To upgrade to a newer version, download the new installer and run it — it will replace the previous installation. Your project data is stored in separate project folders and is not affected by upgrades.

Uninstalling

Go to Settings → Apps → Installed apps, find openstan, and click Uninstall.

Drag the openstan app from Applications to the Trash.

sudo apt remove openstan

sudo dnf remove openstan

Project data

Uninstalling openstan does not delete your project folders or data. These are stored wherever you chose when creating each project.

Code signing

All platform installers are code-signed to verify authenticity and integrity. See the Code signing policy for full details on Windows, macOS, and the build process.

Next Steps

Troubleshooting