Skip to content
GitPersonaGitPersona

Installation

GitPersona ships as a native desktop application for Windows, Linux, and macOS. Pick your platform below, install, and launch.

Download

Get the latest build from the download page. Each release lists the supported platforms and file formats. Release notes and checksums are published alongside every version on GitHub Releases.

Note: GitPersona supports Windows, Linux, and macOS. Secure credential storage uses each platform's native secure store — Windows Credential Manager, the Linux Secret Service, or the macOS Keychain.

Windows

Supported on Windows 10 and Windows 11.

  1. Download the Windows installer (.exe).
  2. Run it. GitPersona installs per-user, so no administrator elevation is required.
  3. Launch GitPersona from the Start menu when the installer finishes.
Tip: Windows SmartScreen may warn about a new publisher on first run. Choose More info → Run anyway if the download came from the official release page.

Linux

Linux builds are distributed as an .AppImage and a .deb package.

  • AppImage — mark it executable (chmod +x GitPersona*.AppImage) and run it directly. No installation step is required.
  • .deb — install on Debian/Ubuntu-based distributions with your package manager, then launch GitPersona from your application menu.

macOS

macOS builds are distributed as a .dmg for Apple Silicon (M1/M2/M3).

  1. Open the .dmg and drag GitPersona to Applications.
  2. Launch it from Applications. On first run, macOS Gatekeeper may ask you to confirm opening an app from an identified developer.
Tip: Credentials are stored in your login Keychain. macOS may prompt to allow GitPersona to access the Keychain the first time a credential is written or read.

First launch

The first time you open GitPersona it scans your system for an existing Git setup — your global identity, SSH keys under ~/.ssh, and any credentials already held for supported hosts — and offers to turn them into your first profile. That flow is covered in Create your first profile.

GitPersona can also run from the system tray. You can choose to launch it at login, start minimized, and keep it running in the tray when the window is closed — see Settings & tray.

Staying up to date

GitPersona checks for updates and can download and install a new version in place, then restart. See Updates for details.