Skip to content
ASTRAL HANDBOOK

Make yourself at home.

Choose the right setup for your computer. Windows has a downloadable beta; Linux and macOS currently use source builds.

Windows BETA DOWNLOAD

Use Windows 10 or 11 on an x64 PC with Microsoft WebView2 installed.

Download Windows installer ↓

The installer is unsigned. A SmartScreen “Unknown publisher” warning concerns publisher identity and reputation; it is not the same as a named malware detection. Do not disable Windows protection. See the FAQ and Microsoft’s explanation.

Linux SOURCE BUILD

Prebuilt Linux packages have not been released or verified yet. You can build the desktop app on a Linux machine using Node.js 24, Rust, and Tauri’s system dependencies.

On Debian/Ubuntu, install the required development libraries and a Secret Service provider for keychain support:

sudo apt update
sudo apt install build-essential curl wget file libwebkit2gtk-4.1-dev libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev libsecret-1-dev libdbus-1-dev pkg-config

Install Rust with its official installer and Node.js 24, then clone the source:

git clone https://github.com/Kraksz/AstralSQL.git
cd AstralSQL
npm ci
npm run desktop:build -- --bundles deb,appimage

Generated packages go into target/release/bundle. Build on the oldest distribution you intend to support and test the resulting package there. For other distributions, follow the official Tauri prerequisites.

macOS SOURCE BUILD

There is no signed or notarized Mac download yet. Build on a Mac with Xcode command line tools, Node.js 24, and Rust installed.

xcode-select --install
git clone https://github.com/Kraksz/AstralSQL.git
cd AstralSQL
npm ci
npm run desktop:build -- --bundles dmg

The DMG is written under target/release/bundle/dmg. A local build is not a verified public release. Distribution needs signing, notarization, and testing on supported Macs. See Tauri’s Mac setup.

iPhone & iPad

The website and documentation are available on phones. Astral does not currently provide an iOS app, App Store download, or remote database client for iPhone/iPad. macOS is the desktop Mac platform; its build cannot be installed on iOS.