Skip to main content

Node

FileFlows Node connects to an existing FileFlows Server and enables distributed processing.
This allows you to process files on multiple computers, extending the processing capacity beyond the main server.

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)"

Adding the Tap​

Add the FileFlows tap to your Homebrew:

brew tap fileflows/tap

Installing FileFlows Node​

Install the FileFlows Node formula:

brew install fileflows-node

This will install FileFlows Node as a Brew service which will automatically start on login.

Configuration​

Run the configuration command to set the server URL and optionally an access token:

fileflows-node --configure

You will be prompted to enter the Server URL (required).

You can enter an Access Token (optional).

This creates or updates the node.config file inside the application data directory.

Application Directory​

The application data is stored at:

$HOME/Library/Application Support/FileFlowsNode

Running the Service​

Start the service with:

brew services start fileflows-node

Stop the service with:

brew services stop fileflows-node

Restart the service with:

brew services restart fileflows-node

Running Manually​

You can also run the FileFlows Node manually by executing:

fileflows-node

Updating​

To force reinstall the latest version of FileFlows Node:

brew reinstall fileflows-node

You may also want to restart the service afterward:

brew services restart fileflows-node

Uninstalling FileFlows Node​

To uninstall FileFlows Node:

brew uninstall fileflows-node

Notes​

  • The launchd service is configured to run as your user (no root required).
  • Configuration must be done once before starting the service.