Install

Querybara ships installers for macOS, Windows and Linux on x64 and arm64. Download them from the releases page on GitHub. Each release also carries SHA256SUMS.txt with the checksums of the installers.

Choose a package

Platform	Packages	Architectures
macOS	DMG	Universal (Apple silicon and Intel)
Windows	NSIS installer (.exe), MSI, zip	x64 and arm64 (one NSIS installer holds both)
Linux	AppImage, deb, rpm	x64 and arm64

Flatpak is not built.

Install

macOS

1. Download the DMG from the releases page. It is a universal build, so the same file runs on Apple silicon and Intel Macs.
2. Open the DMG and drag Querybara to the Applications folder.
3. Open Querybara from Applications.

If the build is not signed (see Unsigned test builds), macOS blocks it the first time it opens. Allow it in System Settings → Privacy & Security, then open it again.

Windows

Pick the package that fits how you install software:

Package	What it does
Querybara-Setup-<version>.exe (NSIS)	Installs for the current user. One installer holds x64 and arm64 and installs the one the machine has. You can choose the folder.
Querybara-<version>-<arch>.msi	Installs for every user of the machine, for managed deployment.
zip	No installer: unpack it and run querybara.exe.

1. Download the package for your architecture from the releases page.
2. Run the installer, or unpack the zip.
3. Start Querybara from the Start menu, or from the unpacked folder.

Windows on arm64

The arm64 packages are built but not yet tested on an arm64 machine by the release workflow. Treat the arm64 install of the NSIS installer as unverified.

Linux

The AppImage runs without installing. The deb and rpm packages install querybara system-wide.

# AppImage
chmod +x Querybara-<version>-<arch>.AppImage
./Querybara-<version>-<arch>.AppImage

# Debian, Ubuntu
sudo apt install ./querybara_<version>_<arch>.deb

# Fedora, RHEL
sudo dnf install ./querybara-<version>.<arch>.rpm

On a system without FUSE, run the AppImage with APPIMAGE_EXTRACT_AND_RUN=1 set.

Unsigned test builds

Release builds are signed and notarised when the project’s signing certificates are set up for the release. Test builds (from pull requests and branch runs, or built locally with pnpm --filter @querybara/desktop package) are not signed and have no update feed:

• macOS asks you to allow them in System Settings → Privacy & Security the first time they open.
• They never check for updates. The About box says “test build”.

Updates

Installed release builds check GitHub for a new version 30 seconds after start-up and every 4 hours, and download it in the background. When it is ready, a notice says “Querybara x.y.z is ready” and offers Restart now. Except for deb and rpm installs, the update also installs when you quit. To check at once, choose Check for Updates… in the Help menu (in the Querybara menu on macOS).

Installed from	How it updates
macOS DMG	Updates itself when the build is signed and notarised.
Windows NSIS installer	Updates itself when the build is code-signed.
Windows MSI or zip	Install the new version yourself (or redeploy it).
Linux AppImage	Updates itself.
Linux deb or rpm	Updates on Restart now, after your system asks for an administrator password.

Stable and beta channels

Open the About box (About Querybara in the Help menu, or in the Querybara menu on macOS; or Help: About Querybara in the command palette) and choose the Updates tab. Update channel offers Stable and Beta:

• Stable follows the latest release that is not a pre-release.
• Beta takes the newest release of either kind, so it gets new versions first.

Switching from beta back to stable never downgrades: the app stays on its beta until a newer stable version ships. Check for updates automatically turns the background checks off; the menu item keeps working.

Administrators can turn updates off or pin the channel for every user of a machine. See Updates and channels for the policy settings and staged rollouts.

Related

• Your first connection
• Updates and channels