Skip to main content

Install

Download the SF Veritas Desktop App for your platform.

Download

Loading downloads...

Installation Notes

macOS

  1. Open the .dmg file and drag SF Veritas to your Applications folder
  2. First launch: Select "Open" - our app is verified malware-free by Apple, so this is a one-time thing you need to do.

Windows

  1. Run the installer (.exe) and follow the prompts
Windows SmartScreen

Since the app is not yet code-signed, Windows SmartScreen may show a warning:

  1. Click "More info"
  2. Click "Run anyway"

This is a one-time step for each new version.

Linux

AppImage:

chmod +x SF-Veritas-*.AppImage
./SF-Veritas-*.AppImage

Debian/Ubuntu (.deb):

sudo dpkg -i sf-veritas_*.deb

No special permissions or workarounds needed on Linux.

Auto-Updates

The Desktop App automatically checks for updates on startup. When a new version is available, you'll be prompted to download and install it.

Setup Wizard

When you first launch SF Veritas, the Setup Wizard will guide you through configuring Sailfish instrumentation for your applications. This automates the code integration process using your preferred AI coding assistant.

Step 1: Welcome

The wizard scans your machine for Git repositories and running processes that can be instrumented with Sailfish.

Setup Wizard Welcome

Click "Get Started" to begin the configuration process. The wizard will:

  1. Configure Scan - Set scan parameters for finding your projects
  2. Repositories - Discover Git repositories on your machine
  3. Processes - Detect running applications that can be instrumented
  4. Install - Generate and run the instrumentation commands

Step 2: Install with AI Assistant

After scanning, select your preferred AI coding assistant to run the installation. The wizard generates a prompt with all the necessary configuration for your detected projects.

AI Tool Selection

Click "Install using Claude Code" (or select another AI tool from the dropdown) to:

  • Open a terminal window
  • Run the generated installation command
  • Automatically configure Sailfish instrumentation in your codebase
Manual Installation

Prefer to install manually? See Integrate with Your Code for step-by-step instructions.

Re-running Setup

You can re-run the Setup Wizard at any time from the Status page. This is useful when you:

  • Add new repositories to your machine
  • Start new applications you want to instrument
  • Need to reconfigure existing instrumentation

Status Page with Re-run Setup

On the Status page, find the Setup Status section and click "Re-run Setup" to launch the wizard again.

Next Steps