Server

FileFlows Server is the main application that all FileFlows instances must first install. It includes its own internal Agent.

If you want a minimal, non-distributed setup, installing this Server alone is sufficient.

Installing Homebrew

If you haven't installed Homebrew yet, install it by running:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Add the FileFlows tap to your Homebrew:

brew tap fileflows/tap

Install the FileFlows formula:

brew install fileflows

This will install FileFlows and register it as a Brew service, which will automatically start on login using macOS's launchd.

The application data is stored at:

$HOME/Library/Application Support/FileFlows

Start the service with:

brew services start fileflows

Stop the service with:

brew services stop fileflows

Restart the service with:

brew services restart fileflows

You can also run FileFlows manually (without using brew services) by executing:

fileflows

To force reinstall the latest version of FileFlows:

brew reinstall fileflows

You may also want to restart the service afterward:

brew services restart fileflows

If Homebrew reports that FileFlows is already up to date but you know a newer version exists, this is usually caused by a cache issue.

Run:

brew cleanup --prune=all

Then reinstall:

brew reinstall fileflows

To uninstall FileFlows:

brew uninstall fileflows

This formula uses a custom no-checksum download strategy to allow downloading a versioned zip without SHA verification.
The launchd service runs as your local user—no root required.
Configuration must be completed before starting the service for the first time.