qalatra/docs/Install Qalatra

Install Qalatra

Pick your OS, run the installer, you're done.

macOS

Download the universal DMG from /download, open it, drag Qalatra into /Applications, then launch it.

If Gatekeeper complains the app is from an "unidentified developer" you can either right-click → Open (recommended) or run:

xattr -dr com.apple.quarantine /Applications/Qalatra.app

Windows

Download Qalatra-Setup.exe. Double-click to install.

Heads up: the installer is currently unsigned. SmartScreen will warn you. Click More info → Run anyway. Code-signing is on the roadmap for v1.0.

Linux

Grab the .AppImage, mark it executable, run it:

chmod +x Qalatra-1.8.0.AppImage
./Qalatra-1.8.0.AppImage

For a headless Linux server install, see Remote instances.

Install via shell (all platforms)

curl -fsSL qalatra.dev/install | sh

The script detects your OS and architecture, downloads the right artifact, verifies its checksum against the GitHub release, and installs it in the standard place for your platform.

Where your data lives

Platform	Data directory
macOS	`~/Library/Application Support/Qalatra/`
Linux	`~/.local/share/qalatra/`
Windows	`%APPDATA%\Qalatra\`

Headless server installs can relocate this with QALATRA_DATA_DIR. See Storage & backup.

Updating

Qalatra checks GitHub releases on launch. When an update is available a subtle indicator appears in the titlebar. Click it, confirm, and the app restarts into the new version. Disable auto-check in Settings → Updates if you'd rather update manually.