Installation - Pontius Documentation

Get Pontius running on your system in under 2 minutes. Available for macOS, Windows, and Linux.

System Requirements

macOS: 10.15 (Catalina) or later, Intel or Apple Silicon
Windows: Windows 10 or later, x86_64 or ARM64
Linux: Any modern distribution, x86_64 or ARM64

macOS

Homebrew (Recommended)

The easiest way to install Pontius on macOS:

brew tap StuJLans/pontius && brew install pontius

Xcode Command Line Tools

Homebrew requires Xcode 26.0+ or the current Command Line Tools. If you see an error about outdated Xcode/CLT, run:

xcode-select --install

Or update Xcode from the App Store.

Manual Installation

Download the appropriate binary from the latest release:

Apple Silicon (M1/M2/M3/M4): pontius_*_darwin_arm64.tar.gz
Intel Mac: pontius_*_darwin_amd64.tar.gz

Then extract and install:

# Extract (replace filename with the one you downloaded)
tar -xzf pontius_*_darwin_*.tar.gz
# Move to your PATH
sudo mv pontius /usr/local/bin/

Linux

Snap (Recommended)

The easiest way to install Pontius on Linux:

snap install pontius

Snap is available on Ubuntu, Debian, Fedora, and most major distributions. If you don't have Snap, see the Snap installation guide.

Manual Installation

Download the appropriate binary from the latest release:

x86_64 (most desktops and servers): pontius_*_linux_amd64.tar.gz
ARM64 (Raspberry Pi 4+, ARM servers): pontius_*_linux_arm64.tar.gz

Then extract and install:

# Extract (replace filename with the one you downloaded)
tar -xzf pontius_*_linux_*.tar.gz
# Move to your PATH
sudo mv pontius /usr/local/bin/

Windows

Manual Installation

Download the appropriate binary from the latest release:

x86_64 (most PCs): pontius_*_windows_amd64.zip
ARM64 (Surface Pro X, etc.): pontius_*_windows_arm64.zip

Then:

Extract the zip file
Move pontius.exe to a folder in your PATH, or add the extracted folder to your PATH

Adding to PATH

To add a folder to your PATH in Windows:

Search for "Environment Variables" in the Start menu
Click "Edit the system environment variables"
Click "Environment Variables"
Under "User variables", select "Path" and click "Edit"
Click "New" and add the folder containing pontius.exe

Verify Installation

After installation, verify Pontius is working by checking the version:

pontius --version

You should see output like:

pontius version 1.0.1

You're ready!

Pontius is installed. Continue to the Quick Start guide to connect your email and run your first blitz session.

Updating Pontius

To update to the latest version:

# Homebrew (macOS)
brew upgrade pontius
# Snap (Linux)
snap refresh pontius

For manual installations, download the latest binary from the releases page and replace the existing one.

Uninstalling

To remove Pontius:

# Homebrew (macOS)
brew uninstall pontius
# Snap (Linux)
snap remove pontius
# Manual (any platform)
# Just delete the pontius binary from your PATH

Removing Your Data

Pontius stores configuration and data in ~/.config/pontius/. To remove everything:

rm -rf ~/.config/pontius

This deletes all your data

This will permanently delete your account configurations, email cache, knowledge base, and drafts. If you want to keep your settings for another device, use pontius sync export first.