Skip to content

DESKTOP.md

Latest commit

 

History

History
78 lines (51 loc) · 3.36 KB

DESKTOP.md

File metadata and controls

78 lines (51 loc) · 3.36 KB

layout: default

title: Desktop Application parent: Applications nav_order: 5 description: "Install the Sage desktop app, first-launch on macOS/Windows, and build from source" lang: en ref: desktop-app

{% include lang_switcher.html %}

Desktop Application

The Desktop app is a Tauri-packaged product: a local HTTP backend on 127.0.0.1 plus a desktop shell UI. It is the best fit for daily offline-friendly work on a single machine without running the full app/server dev stack in terminals.

Topic Where
Installers (.dmg / .exe / .deb) GitHub Releases
Build prerequisites (Rust, Node, Python, Tauri) Desktop build & install — detailed
End-user / ops topics Operations manual · User manual
Architecture Desktop app architecture

Install from release packages

  1. Download the package for your OS from Releases (e.g. .dmg for macOS, NSIS .exe for Windows, .deb for Linux).
  2. Run the installer or drag the app as documented on the download page.
  3. Launch Sage from the Start menu, Applications folder, or app grid.

macOS: Gatekeeper and “damaged” app

Releases are not always Apple-notarized. If you see cannot be opened because the developer cannot be verified or Apple cannot check it for malware:

  1. In Finder → Applications, right-click Sage.app → Open → confirm Open in the dialog.
  2. If still blocked: System Settings → Privacy & Security → find the Sage message → Open Anyway, then try again.
  3. If the app is reported as damaged or will not start, clear quarantine and retry:
xattr -dr com.apple.quarantine /Applications/Sage.app

Windows: SmartScreen

If Windows SmartScreen blocks the installer, use More info → Run anyway (wording can vary by Windows version).

Linux: .deb install

On Debian / Ubuntu, after downloading the matching .deb:

sudo apt install ./Sage-<version>-<arch>.deb

Many desktop environments also support double-clicking the package.

Build from source

From the repository root (see full steps for environment setup):

# macOS / Linux
app/desktop/scripts/build.sh release
# Windows
./app/desktop/scripts/build_windows.ps1 release

Artifacts and platform-specific notes are in the installation guide.

See also