All posts

Docs2 min read

Install GitLane on macOS, Windows, or Linux

Grab a build from GitHub Releases, get past the first-launch warning, and let the signed updater take it from there.

Grab the latest build from Download or the Releases page.

Platform Package
macOS (Apple Silicon) GitLane-<version>-macos-arm64-dmg.dmg
macOS (Intel) GitLane-<version>-macos-x86_64-dmg.dmg
Windows GitLane-<version>-windows-nsis.exe
Linux .deb / .rpm (recommended) or .AppImage

The .sig, .app.tar.gz, and latest.json assets on each release are for the auto-updater. You never need to download them by hand.

First launch

GitLane builds aren't code-signed yet, so macOS Gatekeeper and Windows SmartScreen block the first launch. This is not a broken download. Signing and notarization are planned. In-app updates do not retrigger the warning.

macOS. Copy the app to Applications, then clear the quarantine flag once:

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

Then launch normally. On some systems, right-click → Open, or System Settings → Privacy & SecurityOpen Anyway after the first blocked launch, works instead. Apple Silicon usually says "GitLane is damaged and can't be opened"; Intel usually says "unidentified developer".

Windows. Defender SmartScreen shows "Windows protected your PC". Click More info, then Run anyway. The installer is per-user; no admin rights are needed.

Linux. Prefer .deb (Debian, Ubuntu, Mint) or .rpm (Fedora, openSUSE) so you get an app-menu entry, an icon, and a clean uninstall. Browsers strip the executable bit from an .AppImage, so chmod +x it once. A bare AppImage does not integrate with the desktop.

Staying up to date

GitLane updates itself through a built-in signed updater, on a stable or beta channel — toggle it in Settings → About. See Updates and release channels. Builds you compiled yourself don't use the updater; pull and rebuild instead.

Good to know

The scary warning is expected on first launch. It is Gatekeeper or SmartScreen objecting to an unsigned build, not a damaged download.

Open a repository next: First run.

Full walkthrough: Install.

Installers: Download GitLane.