Skip to main content
Flume accepts a few command-line options for one-off launches and overrides.

​
Options

FlagDescription
-v, --versionPrint version and exit
-h, --helpShow help and exit
-s, --server <name>Connect to a specific server on startup (overrides autoconnect)
-n, --nick <nick>Override the default nickname for all servers
-x, --no-autoconnectDon’t auto-connect to any servers
--no-autoload-scriptsDon’t auto-load scripts on startup

​
Examples

flume                           # normal startup
flume --version                 # print version
flume --help                    # show usage

flume -s libera                 # connect only to "libera" network
flume -n testnick               # use "testnick" as default nick
flume -x                        # start without auto-connecting
flume --no-autoload-scripts     # debug a misbehaving script
flume -x --no-autoload-scripts  # minimal startup, no servers, no scripts

​
Environment Variables

VariableEffect
FLUME_VAULT_PASSAuto-unlock the vault on startup with this passphrase
PYO3_USE_ABI3_FORWARD_COMPATIBILITYSet to 1 when building with newer Python versions (3.14+)