Skip to main content

​
System Requirements

Before installing Flow Browser, ensure your system meets these minimum requirements:

Windows

  • Windows 10 or later
  • 64-bit processor
  • 4GB RAM minimum

macOS

  • macOS 10.13 or later
  • Intel or Apple Silicon
  • 4GB RAM minimum

Linux

  • Modern Linux distribution
  • 64-bit processor
  • 4GB RAM minimum

​
Download Flow Browser

Flow Browser is distributed through GitHub Releases. Choose the appropriate installer for your platform:
1

Visit GitHub Releases

Navigate to the Flow Browser Releases page on GitHub.
2

Download the Latest Version

Download the installer file for your operating system from the latest release (current version: v0.10.1).

​
Available Download Formats

Windows Installer (.exe)Download the file named:
flow-browser-{version}-setup.exe
This installer will:
  • Install Flow Browser to C:\Program Files\Flow
  • Create desktop and start menu shortcuts
  • Register Flow as a browser for http/https protocols
  • Associate HTML and PDF file types with Flow
The executable name is flow.exe once installed.

​
Installation Instructions

# Run the installer
flow-browser-0.10.1-setup.exe

# Follow the installation wizard
# Flow Browser will be installed to:
# C:\Program Files\Flow

# Launch from Start Menu or desktop shortcut

​
Building from Source

For developers who want to build Flow Browser from source:
1

Install Prerequisites

Ensure you have the required development tools:
  • Node.js v22+ (see .nvmrc in the repository)
  • Bun v1.2.0+ (package manager)
  • build-essential and python3 (for native module compilation)
# Install Bun
curl -fsSL https://bun.sh/install | bash

# Install Node.js via nvm
nvm install 22
nvm use 22
2

Clone the Repository

git clone https://github.com/MultiboxLabs/flow-browser.git
cd flow-browser
3

Install Dependencies

# Install all dependencies
bun install
The postinstall script automatically runs electron-builder install-app-deps to rebuild native modules for Electron.
4

Build the Application

Choose the build command for your platform:
# Build for your current platform
bun run build

# Platform-specific builds
bun run build:win     # Windows
bun run build:mac     # macOS
bun run build:linux   # Linux (AppImage, deb, flatpak)
The built application will be in the ./dist directory.

​
Development Build

If you want to run Flow Browser in development mode: 
# Start in preview mode (production-like)
bun start

# Start with hot reloading
bun dev

# Start with file watching (recommended for development)
bun dev:watch

​
File Associations

Flow Browser automatically registers handlers for:

​
Protocols

  • http:// - HyperText Transfer Protocol
  • https:// - Secure HyperText Transfer Protocol

​
File Types

  • .html, .htm - HTML Documents
  • .xhtml, .xhtm - XHTML Documents
  • .mhtml - MHTML Archive
  • .shtml - Server-Side HTML
  • .pdf - PDF Documents (with built-in viewer)

​
Widevine DRM Support

Flow Browser includes Widevine CDM support for streaming protected content:
Flow uses a custom Electron build from @castlabs/electron-releases to enable Widevine support for Netflix, Spotify, and other DRM-protected services.
For advanced users building from source with VMP signing:
  1. Create an EVS account
  2. Configure your credentials in the build environment
  3. The build pipeline will automatically VMP-sign your application

​
Troubleshooting

Flow Browser is not yet signed with an Extended Validation (EV) certificate. To install:
  1. Click “More info” in the SmartScreen warning
  2. Click “Run anyway”
This is safe - Flow Browser is open source and can be audited on GitHub.
Flow Browser is notarized but may still show this warning:
  1. Open System Preferences > Security & Privacy
  2. Click “Open Anyway” next to the Flow Browser warning
  3. Confirm by clicking “Open”
Alternatively, right-click the app and select “Open”.
If you encounter missing dependencies:
# Ubuntu/Debian
sudo apt-get install libgtk-3-0 libnotify4 libnss3 \
  libxtst6 xdg-utils libatspi2.0-0 libdrm2 libgbm1 \
  libasound2

# Fedora
sudo dnf install gtk3 libnotify nss libXtst xdg-utils \
  at-spi2-core libdrm mesa-libgbm alsa-lib
Ensure you have the required build tools:
  • Linux: sudo apt-get install build-essential python3
  • macOS: Install Xcode Command Line Tools: xcode-select --install
  • Windows: Install Visual Studio Build Tools
See node-gyp installation guide for more details.

​
Next Steps

Now that you’ve installed Flow Browser, check out the Quick Start Guide to learn how to use its features.

Quick Start

Get started with Flow Browser in minutes

Features

Explore all available features

Build docs developers (and LLMs) love

Get started for freeTalk to us