Skip to content

Installation Guide

This guide explains how to install Rodrigolab's Flow Cytometry Analyzer on your system.

The easiest way to get started is to download pre-built binaries from the GitHub Releases page.

macOS

  1. Download the .dmg file for your architecture:
  2. Apple Silicon (M1/M2/M3): Rodrigolab's Flow Cytometry Analyzer_*_aarch64.dmg

  3. Intel: Rodrigolab's Flow Cytometry Analyzer_*_x86_64.dmg

  4. Open the downloaded DMG file

  5. Drag the application to your Applications folder

  6. Important - macOS Gatekeeper: Since the app is not code-signed, macOS may show an error that the app is "damaged and cannot be opened". To fix this, use one of the following methods:

Method 1: Remove quarantine attribute (Recommended) 

xattr -cr "/Applications/Rodrigolab's Flow Cytometry Analyzer.app"
Then open the app normally from Applications.

Method 2: Right-click to open - Right-click (or Control-click) the app in Applications - Select "Open" from the context menu - Click "Open" in the security dialog - This only needs to be done once

Method 3: System Settings - Go to System Settings > Privacy & Security - Scroll down to find the blocked app message - Click "Open Anyway" - Confirm by clicking "Open"

After using any of these methods, you can open the app normally in the future.

Windows

  1. Download the .msi installer from the releases page

  2. Double-click the MSI file to run the installer

  3. Windows SmartScreen Warning: Windows may show a warning that it protected your PC. This is normal for unsigned applications. To proceed:

  4. Click "More info" on the warning screen
  5. Click "Run anyway" to continue installation

  6. Alternatively, right-click the MSI file, select "Properties", check "Unblock" if available, then run the installer

  7. Follow the installation wizard

  8. Launch the application from the Start menu

Linux (Ubuntu/Debian)

  1. Download the .deb package from the releases page

  2. Install using your package manager: 

    sudo dpkg -i flow-cytometry-analyzer_*.deb

  3. If there are dependency issues, fix them with: 

    sudo apt-get install -f

  4. Launch from your application menu

Option 2: AppImage

  1. Download the .AppImage file from the releases page

  2. Make it executable: 

    chmod +x Rodrigolab\'s\ Flow\ Cytometry\ Analyzer_*.AppImage

  3. Run it: 

    ./Rodrigolab\'s\ Flow\ Cytometry\ Analyzer_*.AppImage

Building from Source

If you prefer to build from source or need a custom build, see the Building from Source guide.

Quick Build

# Clone the repository
git clone https://github.com/luksgrin/flow-cytometry-analyzer.git
cd flow-cytometry-analyzer

# Install dependencies
npm install

# Build frontend
npm run build

# Build application
cd src-tauri
cargo tauri build

For detailed platform-specific instructions, see Building from Source.

Verification

After installation, verify the application works:

  1. Launch the application
  2. You should see the main interface with "Load FCS File" button
  3. Try loading a sample FCS file to confirm everything works

Updating

To update to a newer version:

  1. Download the latest release from GitHub
  2. Follow the installation steps above
  3. On macOS and Windows, you can typically just install over the existing version
  4. On Linux, uninstall the old version first if using DEB package

Uninstallation

macOS

  1. Open Applications folder
  2. Drag "Rodrigolab's Flow Cytometry Analyzer" to Trash
  3. Empty Trash

Windows

  1. Open Settings > Apps
  2. Find "Rodrigolab's Flow Cytometry Analyzer"
  3. Click Uninstall

Linux (DEB)

sudo apt-get remove flow-cytometry-analyzer

For AppImage, simply delete the file.